Ir al contenido
Canales e integraciones

Webhooks

Haz que tus otras herramientas se enteren al momento de lo que pasa en Entagl.

Descripción general

Un webhook es un mensaje corto que Entagl envía a otra herramienta cuando ocurre algo en tu workspace: una nueva reserva, un chat cerrado, un pedido pagado. Tú eliges los eventos y pegas la dirección web (URL) que te dio la otra herramienta. A partir de ahí, Entagl envía allí los detalles en segundos, para que tu CRM, hoja de cálculo o escenario de Make pueda reaccionar sin que nadie copie datos a mano. Lo encontrarás en Canales → Webhooks.

Para desarrolladores: referencia de la API
Todos los endpoints, campos y eventos de webhook, con ejemplos de código.

Funciones

Elige los eventos que te importan

Los eventos se agrupan en: Contacts, Conversations, Messages, transferencias a tu equipo, AI agent, Bookings, Reminders, Orders, Products, Calls, Campaigns, Forms, Account and channels, y Workspace settings. Abre un grupo y marca eventos individuales, o pulsa Seleccionar todo para tomar todo el grupo. ¿No sabes dónde está algo? Escribe en la caja de búsqueda, por ejemplo "booking" o "tag". Toca cualquier evento para ver un ejemplo exacto de lo que enviará Entagl. Algunos eventos también te permiten elegir de dónde provienen, así que podrías recibir solo las reservas que hizo tu AI y saltarte las que tu equipo escribió en el calendario.

Incoming message y Outgoing message: lee primero la advertencia

Mensaje entrante y Mensaje saliente se activan por cada mensaje. En una cuenta ocupada pueden ser miles al día. Por eso Seleccionar todo los omite: tienes que marcarlos uno por uno, junto a una advertencia. Actívalos solo si la herramienta del otro lado puede manejar tanto volumen. Si solo quieres saber cuándo empieza o termina un chat, Conversación abierta y Conversación cerrada generan mucha menos actividad.

Los datos del cliente se quedan fuera, salvo que tú los incluyas

Dos interruptores deciden cuánta información del cliente sale de Entagl. Incluir contenido del mensaje añade lo que escribieron los clientes: mensajes, notas y resúmenes de llamadas. Incluir datos de contacto añade el nombre, el número de teléfono y el email del cliente. Ambos empiezan desactivados. Aun así recibes todos los eventos sin ellos, con un ID de contacto donde irían los detalles. Solo el propietario del workspace o un administrador puede activarlos, y solo hazlo si la herramienta receptora tiene permiso para guardar datos de clientes. En un workspace HIPAA nunca se envían datos del cliente, sin importar lo que indiquen los interruptores.

Apps conectadas

Las herramientas y los desarrolladores pueden registrar sus propios webhooks mediante la API de Entagl, y aparecen solos en Aplicaciones conectadas. En cada una ves cuántos eventos escucha y cuándo recibió el último. Puedes abrir sus Entregas recientes, pulsar Pausar o Reanudar, o pulsar Quitar. Los scenarios de Make tienen su propia página: Canales → Make.

Ver lo que se envió y reenviarlo

Pulsa Entregas recientes para ver los últimos 50 eventos que Entagl intentó enviar, del más reciente al más antiguo. Cada uno muestra si llegó, la respuesta que dio tu herramienta (como 200 o 500), cuántos intentos hizo y cuándo toca el siguiente. Cuando una entrega ya ha fallado definitivamente, corrige el problema de tu lado y pulsa Enviar de nuevo. Entagl lo envía en unos segundos.

Reintentos y qué pasa cuando una herramienta sigue fallando

Si tu herramienta no está disponible o responde con un error, Entagl vuelve a intentarlo después de 30 segundos, 2 minutos, 10 minutos, 1 hora, 6 horas y 24 horas. Son unas 31 horas antes de que una entrega se marque como fallida. Si una app conectada sigue fallando durante 3 días seguidos, Entagl la pausa y envía una notificación al propietario del workspace. Arregla la herramienta y luego pulsa Reanudar. Si Make informa de que el webhook de un scenario ya no existe, Entagl deja de enviarle de inmediato.

Comprueba que una solicitud realmente vino de Entagl

Cada solicitud lleva una firma en el encabezado X-Entagl-Signature, generada con tu signing secret. Tu desarrollador la usa para demostrar que la solicitud vino de Entagl y que nadie la modificó por el camino.

  • Connected apps y webhooks creados mediante la API envían t=1767225600,v1=5257a869…. La parte t indica cuándo se envió, en segundos. Cada v1 es un HMAC-SHA256 del texto timestamp.body (el valor t, un punto y luego el cuerpo bruto de la solicitud), generado con tu secret. Rechaza cualquier solicitud cuyo t tenga más de 5 minutos, para que no se pueda reutilizar una solicitud antigua. Justo después de un cambio de secret podrías ver dos valores v1: acepta la solicitud si cualquiera de los dos coincide.
  • El webhook que configuras en esta página envía sha256= seguido de un HMAC-SHA256 del cuerpo bruto de la solicitud.

Tareas comunes

Conectar un webhook

Acerca de 3 min
  1. Ve a Canales y abre Webhooks.
  2. Pega en URL del webhook la URL que te dio tu otra herramienta. Debe empezar por https://.
  3. En Eventos, marca lo que quieras recibir. Deja desactivados los dos interruptores de datos del cliente, salvo que la herramienta receptora necesite de verdad nombres o mensajes.
  4. Guarda. Copia el secreto de firma de la ventana que se abre y guárdalo en un lugar seguro. Solo se muestra una vez.
  5. Comprueba que el interruptor de la parte superior de la tarjeta esté activado y muestre Activo. Los eventos empezarán a fluir a partir de ese momento.

Prueba tu webhook

Acerca de 1 min
  1. Abre Canales → Webhooks y busca Probar entrega.
  2. Pulsa Enviar prueba. Entagl envía enseguida un evento de ejemplo a tu URL.
  3. Revisa el resultado. Prueba entregada significa que tu herramienta respondió. Si falló, el mensaje te dirá por qué (por ejemplo, un timeout), para que puedas corregirlo y volver a intentarlo.

Consejos

Cada request incluye un event ID en el header X-Entagl-Event-Id. Si llega un retry de algo que tu herramienta ya procesó, usa ese ID para omitirlo.
En el webhook que configures en esta página, Cita creada y Documentos de la reserva añadidos se envían una sola vez, en el momento en que ocurren, sin el retry schedule. Mantén esa URL accesible.
Responde rápido. Tu herramienta debe devolver un código de éxito (cualquier 2xx) en menos de 5 segundos y hacer el trabajo pesado después. Una respuesta lenta cuenta como fallo y se reintentará.
Pausar es la opción suave: la conexión se mantiene, no se envía nada, y Reanudar retoma con eventos nuevos. Quitar elimina la conexión.

Preguntas frecuentes

¿Te fue útil esta página?