Usar webhooks de ActiveCampaign

Marketing_Lite_Plus_Professional_Enterprise

Sales_Plus_Professional_Enterprise

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

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. 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.

No es necesario crear un webhook en "Configuración del desarrollador" para enviar un webhook desde una automatización. 

href="https://help.activecampaign.com/hc/es/articles/115000161204" target="_blank" rel="noopener">enviar un webhook desde una automatización

Crear un webhook en Configuración del desarrollador

Disponible en planes de Marketing y Ventas.

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

  1. Haga clic en Configuración y, a continuación, haga clic en Programador.
  2. Haga clic en el botón "Administrar Webhooks".
  3. Haga clic en el botón "Agregar".
  4. Aparecerá una ventana modal. Elige el tipo de webhook que quieres crear.
  5. 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 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 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.

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 9 de 31

¿Tienes más preguntas? Envía una solicitud

Start free trial