Webhooks de proveedores de chat

Cómo Slack, Microsoft Teams, Discord, Telegram y GitHub entregan mensajes a Veyra, cómo se verifica cada entrega y qué límites se aplican.

Veyra Docs TeamActualizado el 2 min de lecturaVersión 2 · Historial

Cuando conectas un canal de chat, el proveedor envía cada mensaje y evento a Veyra en:

HTTP
POST https://intelligence-api.veyra.so/api/chat-webhooks/{publicId}/{provider}

provider es slack, microsoft-teams, discord, telegram o github. publicId identifica tu endpoint; la consola completa la dirección durante la configuración y tú la pegas en los ajustes de la app del proveedor.

Verificación

Veyra verifica cada entrega con el mecanismo propio del proveedor antes de leerla:

Proveedor Se verifica con
Slack El secreto de firma de la app (X-Slack-Signature y X-Slack-Request-Timestamp).
Microsoft Teams El token de Bot Framework de la solicitud.
Discord La clave pública de la aplicación (cabeceras de firma Ed25519).
Telegram El token secreto definido al registrar el webhook.
GitHub El secreto de webhook de la GitHub App (X-Hub-Signature-256).

Una entrega que no supera la verificación se rechaza y no se lee nada de ella. Los secretos de verificación los introduce una persona durante la configuración, nunca un agente.

Límites

Cada endpoint acepta hasta 600 solicitudes por minuto por dirección de origen. Las respuestas llevan X-RateLimit-Limit y X-RateLimit-Remaining; por encima del límite, Veyra responde 429 con Retry-After y los proveedores reintentan según su propio calendario.

Respuestas

Veyra responde en el formato que espera cada proveedor (por ejemplo, el desafío de verificación de URL de Slack o el acuse de interacción de Discord). Un proveedor no admitido, o que tiene su propia ruta (correo, voz), recibe 400.

Entrega y reintentos

Los proveedores reintentan las entregas fallidas. Veyra reconoce las repeticiones por el ID de evento o de entrega del proveedor, así que un reintento nunca crea una segunda tarea ni una segunda respuesta.

Qué pasa con un mensaje

  1. La identidad del remitente se asocia a un miembro vinculado de Veyra. Los remitentes no vinculados reciben un enlace para confirmar quiénes son.
  2. Un hilo nuevo se convierte en una tarea para el agente del endpoint; una respuesta continúa la tarea.
  3. La respuesta del agente se publica en el mismo hilo.

Consulta Canales de chat en la referencia de la API para gestionar los endpoints.

Canales de chatEntrantesWebhooks