Webhooks
Un webhook es un mensaje automatizado de un sistema a otro que se envía cuando se cumplen ciertos criterios. En Braze, estos criterios suelen ser el desencadenamiento de un evento personalizado. Los webhooks proporcionan acceso dinámico y flexible a datos y funcionalidad programática, y te permiten configurar recorridos del cliente que optimizan los procesos.
Requisitos previos
La disponibilidad de los webhooks depende de tu paquete de Braze. Ponte en contacto con tu director de cuentas o con tu administrador de éxito de cliente para empezar.
Casos de uso
Los webhooks son una forma excelente de conectar tus sistemas entre sí; al fin y al cabo, los webhooks son la forma en que las aplicaciones se comunican. Estos son algunos escenarios generales en los que los webhooks pueden ser especialmente útiles:
- Enviar datos a Braze y desde Braze
- Enviar mensajes a tus clientes a través de canales que Braze no admite directamente
- Publicar en las API de Braze
Algunos casos de uso más específicos son los siguientes:
- Crear un flujo de trabajo de puntuación de clientes potenciales mediante webhooks y Canvas para calificar y dirigir los clientes potenciales.
- Si un usuario cancela su suscripción al correo electrónico, puedes hacer que un webhook actualice tu base de datos de análisis o tu CRM con esa misma información, para tener una visión integral del comportamiento de ese usuario.
- Enviar mensajes transaccionales a usuarios en Facebook Messenger o Line.
- Enviar correo directo a los clientes en respuesta a su actividad en la aplicación y en la Web usando webhooks para comunicarte con servicios de terceros como Lob.com.
- Si un jugador alcanza un determinado nivel o acumula un determinado número de puntos, usa webhooks y tu configuración de API existente para enviar una mejora de personaje o monedas directamente a su cuenta. Si envías el webhook como parte de una campaña de mensajería multicanal, puedes enviar al mismo tiempo un push u otro mensaje para informar al jugador sobre la recompensa.
- Si eres una aerolínea, puedes usar webhooks y tu configuración de API existente para acreditar un descuento en la cuenta de un cliente después de que haya reservado un determinado número de vuelos.
- Infinitas recetas de “If This Then That” (IFTTT); por ejemplo, si un cliente inicia sesión en la aplicación mediante correo electrónico, esa dirección puede configurarse automáticamente en Salesforce.
Gestión de errores de webhooks y limitación de velocidad
Braze solo reintenta la entrega de webhooks para determinadas respuestas HTTP (por ejemplo, 408, 429 y 5XX). La mayoría de las demás respuestas, incluidas 401 Unauthorized y otros errores 4XX, no se reintentan. Los encabezados de respuesta como Retry-After y X-Rate-Limit-* pueden influir en el tiempo de espera entre reintentos cuando una respuesta ya cumple los requisitos para reintentarse. Sin embargo, no hacen que Braze reintente errores que estén fuera del conjunto de errores reintentables.
Para ver la tabla completa de códigos de respuesta, los límites de reintentos y el comportamiento de los tiempos de espera, consulta Códigos de respuesta y lógica de reintento.
Si la mayoría de las solicitudes de webhook a un host específico fallan, Braze aplaza temporalmente todos los intentos de envío a ese host. El envío se reanuda tras un periodo de enfriamiento definido, lo que permite que tu sistema se recupere.
Uso de webhooks con partners de Braze
Hay muchas formas de usar webhooks y, con nuestros partners tecnológicos (Alloys), puedes usar webhooks para mejorar tu comunicación directamente con tus clientes y usuarios.
Consulta:
- Messenger
- Remerge
- Lob.com
- ¡Y muchos más de nuestros partners tecnológicos!