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 aplicación 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 que se envían de un sistema a otro cuando se produce un evento específico. Puede usar webhooks para enviar datos desde su cuenta de ActiveCampaign para actualizar una base de datos o aplicación externa con actividades de contacto, campaña, oportunidad de venta y objetos personalizados a métrica que ocurren.
Por ejemplo, es posible que desee crear un webhook para enviar datos a una base de datos externa cada vez que se actualiza un registro de contacto, cuando se agrega una cuenta, cuando se crea una tarea de oportunidad de venta o cuando un contacto hace 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
Disponible en los planes Marketing Enterprise y Sales Enterprise.
Utilice webhooks de objetos personalizados para publicar datos en un origen de terceros cuando se produzca una acción con un objeto personalizado. Utilice Webooks personalizados para publicar datos en un origen de terceros cuando se produzca una acción con un objeto personalizado, incluidos los objetos personalizados importados de una integración de terceros compatible y los objetos personalizados que cree mediante la API o la página "Administrar datos" de su cuenta.
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 un origen de terceros cada vez que se complete una acción o eventos especificados.
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.
No es necesario crear un webhook en "Configuración del desarrollador" para enviar un webhook desde una automatización.
Obtén información sobre cómo enviar un webhook desde una automatización.
Crear un webhook en Configuración del desarrollador
Disponible en planes de Marketing y Sales.
Con esta configuración, puede elegir qué tipo de webhook crear.
- Haga clic en "Configuración" y luego haga clic en "Desarrollador".
- 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 desencadenará 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 desencadenarse 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, de ecommerce y de aplicaciones:
- Proporciona un nombre para tu webhook
- Haga clic en el menú desplegable "Tipo" para seleccionar la acción o el evento que desencadenará 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 estándar:
Cómo se reciben los datos de un webhook
Los datos que reciba se enviarán como un parámetro POST a su URL. Vea una lista de los campos que se enviarán en su webhook.
Si utiliza la acción de automatización de webhook, puede encontrar los datos específicos que se envían aquí.
ActiveCampaign garantiza al menos una vez la entrega de webhooks. Esto significa que a veces enviaremos un webhook más de una vez para un solo evento.
Caracteres y límites válidos para webhooks
Puede usar caracteres alfanuméricos, además de los siguientes caracteres especiales en su URL de webhook:
"$-_.+!*' (),"
No hay límites de caracteres en el número de caracteres incluidos en una nota u otro campo en un webhook.
Probar el webhook
Para probar su webhook, haga clic en el botón "Enviar datos de muestra" ubicado en la página Configuración > Developer > Webhooks en su cuenta de ActiveCampaign. Una vez que se haga clic, enviaremos los datos de prueba a la URL especificada en la barra de URL de su webhook.