Webhooks des fournisseurs de chat

Comment Slack, Microsoft Teams, Discord, Telegram et GitHub transmettent les messages à Veyra, comment chaque livraison est vérifiée, et les limites qui s'appliquent.

Veyra Docs TeamMis à jour le 1 min de lectureVersion 2 · Historique

Quand vous connectez un canal de chat, le fournisseur envoie chaque message et événement à Veyra à l'adresse :

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

provider vaut slack, microsoft-teams, discord, telegram ou github. publicId identifie votre endpoint ; la console remplit l'adresse complète pendant la configuration, et vous la collez dans les réglages de l'application chez le fournisseur.

Vérification

Veyra vérifie chaque livraison avec le mécanisme propre au fournisseur avant de la lire :

Fournisseur Vérifié avec
Slack Le secret de signature de l'application (X-Slack-Signature et X-Slack-Request-Timestamp).
Microsoft Teams Le jeton Bot Framework présent sur la requête.
Discord La clé publique de l'application (en-têtes de signature Ed25519).
Telegram Le jeton secret défini lors de l'enregistrement du webhook.
GitHub Le secret de webhook de la GitHub App (X-Hub-Signature-256).

Une livraison qui échoue à la vérification est refusée et rien n'y est lu. Les secrets de vérification sont saisis par une personne pendant la configuration, jamais par un agent.

Limites

Chaque endpoint accepte jusqu'à 600 requêtes par minute et par adresse source. Les réponses portent X-RateLimit-Limit et X-RateLimit-Remaining ; au-delà de la limite, Veyra répond 429 avec Retry-After, et les fournisseurs relancent selon leur propre calendrier.

Réponses

Veyra répond sous la forme attendue par chaque fournisseur (par exemple le défi de vérification d'URL de Slack, ou l'accusé d'interaction de Discord). Un fournisseur non pris en charge, ou qui a sa propre route (e-mail, voix), reçoit 400.

Livraison et relances

Les fournisseurs relancent les livraisons échouées. Veyra reconnaît les répétitions grâce à l'identifiant d'événement ou de livraison du fournisseur : une relance ne crée jamais de deuxième tâche ni de deuxième réponse.

Ce que devient un message

  1. L'identité de l'expéditeur est rapprochée d'un membre Veyra lié. Un expéditeur non lié reçoit un lien pour confirmer qui il est.
  2. Un nouveau fil devient une tâche pour l'agent de l'endpoint ; une réponse poursuit la tâche.
  3. La réponse de l'agent est publiée dans le même fil.

Voir Canaux de chat dans la référence de l'API pour gérer les endpoints.

Canaux de chatEntrantsWebhooks