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.
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 :
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.