Usar webhooks de ActiveCampaign

Sarah N

Última actualización 17 de marzo de 2025 16:31

Consultoría técnica

¿No sabes por dónde empezar? Programe una sesión individual con un experto en API e integración por sólo 79 USD.

Con ActiveCampaign, puede usar webhooks para enviar actualizaciones en tiempo real sobre su contacto y actividad de campaña a una fuente externa.

Toma nota

Al crear un webhook, la app receptora debe aceptar solicitudes POST y tener una API. Además, solo admitimos el envío de solicitudes HTTPS al puerto HTTPS predeterminado (puerto 443)
ActiveCampaign no acepta webhooks entrantes
Las cargas útiles de Webhook no se pueden personalizar. La especificación de autorización se limita a la URL y los parámetros de URL

¿Qué es un webhook?

Los webhooks son mensajes automatizados enviados de un sistema a otro cuando se produce un evento especificado. Puede usar webhooks para enviar datos desde su cuenta de ActiveCampaign para actualizar una base de datos o app externa con actividades de contacto, campaña, oportunidad de venta y objetos personalizados a medida que ocurren.

Por ejemplo, es posible que desee crear un webhook para enviar datos a una base de datos externa cada vez que se actualice un registro de contacto, cuando se agregue una cuenta, cuando se cree una tarea de oportunidad de venta o cuando un contacto haga clic en un enlace de su correo electrónico.

Hay dos tipos de webhook Standard y Custom Object. La disponibilidad de estos tipos de webhook depende del tipo de plan que tengas. Por ejemplo, algunas cuentas pueden tener acceso a ambos tipos, mientras que otras solo tendrán webhooks estándar.

Tipos de webhook

ActiveCampaign ofrece dos tipos de webhooks: objeto estándar y objeto personalizado.

Webhooks de objetos estándar

La disponibilidad de algunos objetos estándar depende de su plan de ActiveCampaign.

Puede usar webhooks estándar para publicar datos en un origen de terceros cuando se produce una acción.

Los webhooks de objetos estándar incluyen contactos, oportunidades de venta, cuentas, campañas, sitio web y eventos SMS.

Aquí hay una lista de las acciones disponibles para desencadenar un webhook estándar:

Cuenta : agregada o actualizada
Campaña : reenviada, abierta, compartida, comienza a enviarse
Contacto : agregado o actualizado a su ActiveCampaign, agregado, actualizado o eliminado en una cuenta en su ActiveCampaign, nota agregada, etiqueta agregada o eliminada, tarea agregada, cancelación de suscripción
Oportunidad de venta : agregada o actualizada, nota agregada, embudo agregado, etapa agregada, tarea agregada o completada, tipo de tarea agregada
Correo electrónico - rebotado, respondido
Enlace - clicado
Lista - añadida
SMS - respondido, enviado, cancelación de suscripción

Webhooks de objetos personalizados

Utilice webhooks de objetos personalizados para publicar datos en un origen de terceros cuando se produzca una acción con un objeto personalizado. Esto incluye objetos personalizados importados de una integración de terceros compatible y objetos personalizados que cree mediante la API o la página "Administrar datos" de su cuenta.

Para los usuarios de Shopify y WooCommerce, los webhooks de objetos personalizados están disponibles para:

Pedidos: creados, actualizados, eliminados
Productos: creados, actualizados, eliminados

Dónde se crean los webhooks

Hay dos lugares donde puede crear un webhook en ActiveCampaign: Configuración del desarrollador y Automatización.

Configuración del desarrollador en Mi configuración

Publicará datos en una fuente de terceros cada vez que se complete una acción o evento especificado.

Acción de automatización de webhook

Publicará datos en otra URL una vez que un contacto interactúe con la acción Webhook en una automatización.

Esta acción solo funciona con webhooks de objetos estándar.

Descubra cómo enviar un webhook desde una de automatización.

Opciones de iniciación de webhooks

A continuación se muestran las opciones de iniciación de webhooks:

Iniciado por un contacto: Esta opción ejecuta ganchos cuando un contacto provoca la acción. Por ejemplo, cuando un contacto abre una campaña
Iniciado por cualquier usuario: Ejecuta los ganchos cuando un administrador de la cuenta provoque la acción. Por ejemplo, cuando se añade un contacto desde el área de administración
Iniciados por procesos del sistema: En este caso, ejecuta los ganchos cuando los sistemas automatizados ejecutan la acción. Un ejemplo sería cuando un correo electrónico rebota
Iniciado por la API: Ejecuta los ganchos cuando la llamada a la API provoca la acción. Por ejemplo, al añadir un contacto mediante la llamada a la API contact_add

Crear un webhook en Configuración del desarrollador

Con esta configuración, puede elegir qué tipo de webhook crear.

Haga clic en "Configuración" en el menú de la izquierda.
Haga clic en el botón "Administrar Webhooks".
Haga clic en el botón "Agregar".
Aparecerá una ventana modal. Elige el tipo de webhook que quieres crear.
En la siguiente pantalla, completa los campos para crear tu webhook:
- Webhooks de objetos estándar:
  - Complete los campos de nombre y URL. El campo URL es donde se publicará el webhook cuando se produzca la acción
  - En el menú desplegable "Tipo", seleccione la acción o el evento que activará la ejecución del webhook. Puede seleccionar varios eventos
  - Seleccione desde dónde deben inicializarse las acciones. Por ejemplo, puedes elegir si el webhook debe activarse a partir de la acción de un contacto o de la acción de un usuario de la cuenta
  - Seleccione la lista a la que se debe asociar el webhook. Este campo de lista solo aparecerá si el tipo de webhook requiere una lista
  - Haga clic en el botón "Guardar"
- Webhooks personalizados y de Apps:
  - Proporciona un nombre para tu webhook
  - Haga clic en el menú desplegable "Tipo" para seleccionar la acción o el evento que activará la ejecución del webhook. Puede seleccionar varios eventos
  - Proporcione la URL en la que el webhook debe publicar
  - Haga clic en el botón "Guardar"
- Webhooks de objetos personalizados de ecommerce:
  - Proporciona el nombre de tu webhook
  - Proporcione la URL en la que el webhook debe publicar
  - Haga clic en el menú desplegable "Tipo" para seleccionar la acción o el evento que activará la ejecución del webhook. Puede seleccionar varios eventos
  - Haga clic en el botón "Guardar"

Cómo se reciben los datos del webhook

Los datos que reciba se enviarán como un parámetro POST a su URL. Vea una lista de campos que se enviarán en su webhook.

Si utiliza la acción de automatización webhook, puede encontrar los datos específicos enviados aquí.

ActiveCampaign garantiza la entrega de webhooks al menos una vez. Esto significa que, en ocasiones, puede enviar un webhook más de una vez para un mismo evento.

Caracteres válidos y límites para webhooks

Puedes usar caracteres alfanuméricos, además de los siguientes caracteres especiales en la URL de tu webhook:
"$-_.+!*' (),"

No hay límites de caracteres en el número de caracteres incluidos en una nota u otro campo en un webhook.

Probando tu webhook

Para probar tu webhook, haz clic en el botón "Enviar datos de muestra" ubicado en la página Configuración > Developer > Webhooks en tu cuenta de ActiveCampaign. Una vez hecho clic, enviaremos los datos de prueba a la URL especificada en la barra de URL de tu webhook.