Webhook e-mail

Comment le courrier destiné à la boîte d'un agent arrive dans Veyra via AgentMail, comment chaque livraison est vérifiée par des signatures Svix, et comment les réponses s'enchaînent.

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

Un agent peut avoir sa propre adresse e-mail. Le courrier envoyé à cette adresse arrive par le fournisseur AgentMail, qui le livre à Veyra à l'adresse :

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

Vérification

AgentMail signe chaque livraison avec Svix. Avant de lire quoi que ce soit, Veyra vérifie les en-têtes svix-id, svix-timestamp et svix-signature par rapport au secret de signature de la boîte, sur le corps brut. Une livraison sans signature valide est refusée.

Réponses

Statut Signification
204 Acceptée.
403 Le corps n'a pas été livré en octets bruts, ou la vérification de signature a échoué.
Autres 4xx La boîte n'existe pas, est en pause ou a été déconnectée.

Le fournisseur relance les livraisons échouées ; le svix-id empêche une relance de créer un deuxième message.

Ce que devient un e-mail

  • Un nouvel e-mail lance une tâche pour l'agent de la boîte.
  • Une réponse dans un fil où se trouve l'agent poursuit cette tâche.
  • Les pièces jointes sont stockées avec la tâche après les vérifications habituelles des fichiers.

Le courrier sortant de l'agent appartient toujours à une tâche. Une réponse est liée au message auquel elle répond et ne peut changer ni ses destinataires ni son objet. Un envoi en file d'attente n'est pas encore livré ; l'état de livraison indique quand le fournisseur l'a accepté.

Mise en place

Connectez l'e-mail depuis Connectors comme un canal de chat. La configuration enregistre le webhook auprès d'AgentMail pour vous.

Voir E-mail dans la référence de l'API.

E-mailEntrantsWebhooks