Un chat est une conversation écrite avec le même agent qui prend vos appels : ses instructions, fonctions, connaissances et règles de transfert s'appliquent toutes, simplement rien n'est dit à voix haute. Votre serveur envoie chaque message et reçoit toute la réponse de l'agent dans la réponse HTTP. Les chats sont facturés par message envoyé par la personne, et chacun est un enregistrement d'appel : il apparaît dans Appels (marqué Texte), est analysé, envoyé à vos webhooks et supprimé avec les données d'un appelant comme tout appel.
curl https://evasay.com/api/v1/voice/chats \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "agent_id": "AGENT_ID", "message": "Do you deliver on Sundays?", "user_id": "u_42" }'
{
"data": {
"chat_id": "vc_…",
"reply": "We do, between 10 am and 4 pm. Would you like to book a slot?",
"cards": [],
"quick_replies": [],
"ended": false
}
}
user_id (votre identifiant pour la personne) et variables (des valeurs auxquelles l'agent et ses fonctions peuvent se fier) fonctionnent comme pour les jetons d'appel web.cards et quick_replies sont ce que l'agent afficherait lors d'un appel web (voir Appels sur votre site et dans votre app).curl https://evasay.com/api/v1/voice/chats/CHAT_ID/messages \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "message": "Yes, this Sunday at noon." }'
La réponse a les mêmes champs. Un message fait au plus 500 caractères. Envoyez-en un à la fois et attendez sa réponse : un message envoyé pendant que l'agent répond encore reçoit 409 chat_busy, et un message envoyé moins d'une seconde après le précédent reçoit 429 rate_limited.
Si le worker qui exécute le chat a disparu (un redémarrage), un nouveau chat le poursuit avec la conversation jusque-là et répond à votre message ; la réponse contient alors continued_from avec l'identifiant de l'ancien chat. Utilisez ensuite le nouveau chat_id.
Un chat se termine après 30 minutes sans message, deux heures après son début, à 100 messages, quand l'agent y met fin ou quand vous y mettez fin :
curl https://evasay.com/api/v1/voice/chats/CHAT_ID/end \
-X POST \
-H "Authorization: Bearer sk-your-key"
Il est alors analysé, envoyé à vos webhooks comme call.ended et facturé. Un message à un chat terminé reçoit 409 chat_ended. Pour continuer, démarrez un nouveau chat avec previous_chat_id : l'agent reçoit la conversation précédente (ses 50 derniers messages), et l'enregistrement du nouveau chat commence vide. ended: true dans une réponse signifie que l'agent a terminé le chat avec cette réponse. human: true signifie qu'un membre de votre équipe a pris la conversation en charge dans la Boîte de réception : l'agent ne répond pas et reply est vide.
Un espace de travail peut avoir un certain nombre de chats ouverts en même temps, en plus de ses appels ; quand ils sont tous ouverts, un nouveau chat reçoit 429 chat_limit jusqu'à ce qu'un se termine.
| Code | Statut | Quand |
|---|---|---|
invalid_message | 400 | Pas de message, ou plus de 500 caractères |
chat_not_found | 404 | Aucun chat de ce type dans l'espace de travail (ou previous_chat_id n'en est pas un) |
chat_busy | 409 | L'agent répond encore au dernier message |
chat_ended | 409 | Le chat est terminé ; démarrez-en un nouveau avec previous_chat_id |
chat_message_limit | 409 | Le chat a reçu 100 messages |
rate_limited | 429 | Moins d'une seconde après le dernier message |
chat_limit | 429 | L'espace de travail a autant de chats ouverts qu'il le peut |
insufficient_credits | 402 | Pas assez de crédits pour démarrer un chat |
chat_timeout | 504 | L'agent n'a pas terminé sa réponse à temps ; réessayez |
chat_unavailable | 503 | L'agent n'a pas pu répondre pour le moment ; réessayez |
Le widget et la page hébergée proposent de parler et d'écrire ; dans Agents → Déployer, vous pouvez n'en proposer qu'un. Les conversations écrites sur une page sont facturées par message comme les chats. Voir Appels sur votre site et dans votre app.