Además de enviar mensajes y etiquetar (o quitar etiquetas a) tus clientes, ahora puedes orquestar acciones y workflows en otras aplicaciones y sistemas con webhooks en Series.
Con webhooks en Series puedes usar cualquier evento o conjunto de filtros en Intercom, para hacer cosas como:
Mantener los datos de los clientes sincronizados entre múltiples sistemas.
Enviar notificaciones internas a tu equipo cuando los users alcancen un hito en una Series.
Realizar actualizaciones en tu propia aplicación o base de datos personalizada.
¿Qué es un webhook?
Un webhook es un mensaje enviado desde Intercom cuando un user cumple con los criterios que especificas (como completar un evento). Tiene un mensaje—o “payload”—y se envía a una URL única de tu elección.
Por ejemplo, esta es una serie simple que envía un webhook después de que un user realiza una acción determinada:
El webhook contiene el nombre del user, el nombre de la empresa y el ID. El payload del webhook se ve así:
POST https://examply.io/webhooks
Content-Type: application/json
{
name: “Lonnie Lynn”
company: “CSense Ltd”
company_id: “c0m5en5e”
}
La aplicación que recibe el webhook, puede luego hacer algo (o muchas cosas) con los datos en el payload. 👌
Nota: El envío de webhooks con Series solo está disponible en ciertos planes de Intercom. Consulta nuestros planes y precios aquí.
Cómo agregar un webhook a una series
Arrastra un webhook desde el menú de la derecha y conéctalo a tu series después de cualquier bloque de regla que quieras para activarlo:
Abre el bloque de webhook y asígnale un título:
Ahora puedes configurar exactamente qué datos enviar y a dónde enviarlos.
Consejo profesional: Si envías un webhook a otra aplicación (como Zapier, por ejemplo) usualmente puedes encontrar el tipo de solicitud, la URL del webhook y cualquier encabezado necesario en su documentación. Si envías un webhook a tu propia aplicación, tus ingenieros deberían poder proporcionar esta información. 👌 |
Comencemos con el método HTTP y la URL del webhook:
Para el método, puedes elegir entre PUT o POST, y la URL es para la aplicación que debe recibir el webhook.
Consejo: Puedes usar RequestBin o un servicio similar para pruebas.
Luego, agrega cualquier encabezado de webhook como pares clave-valor:
Solo el encabezado Content-Type es obligatorio para enviar un webhook (JSON o URLencoded), sin embargo, pueden ser necesarios encabezados adicionales para recibir el webhook.
Por ejemplo, puede que necesites autenticarte con la aplicación receptora.
Para agregar nuevos encabezados, solo haz clic en “+ Agregar un par clave-valor”
Opcionalmente, selecciona los datos para incluir en el cuerpo del webhook como pares clave-valor. En este ejemplo, enviamos el nombre, el nombre de la empresa y el ID de la empresa.
Para datos dinámicos, agrega atributos de Intercom con el menú “{...}”:
Probando tu webhook
Antes de activar tu series, recomendamos probar tu webhook para asegurarte de que se envía y recibe como esperas. Haz clic en “Probar”:
Escribe el nombre o correo electrónico de un user de prueba para que puedas ver sus datos poblados en el payload del webhook:
Luego selecciónalo y haz clic en “Ejecutar prueba”:
Verás la respuesta devuelta por la aplicación receptora:
Nota: Deberías ver un código de éxito “200”, cualquier otro código puede requerir solución de problemas con la aplicación receptora.
¿Qué pasa si un webhook falla?
Si un webhook tiene éxito, registramos una estadística de “Enviado”. Si falla, intentaremos enviarlo 2 veces más. Después del tercer intento, el punto de control se marcará como “Fallido”. Puedes ver estos resultados haciendo clic en el webhook una vez que tu series esté activa. 👍