Cet endpoint remplace le corps markdown du résumé d'appel généré par l'IA, par exemple après qu'un agent a relu le texte automatique et l'a corrigé.
Seuls les appels ont un résumé. Envoyer l'ID d'un SMS (msg-*) renvoie 400 INVALID_ITEM_ID.
Lorsque le résumé que vous modifiez est celui qu'Allo affiche par défaut pour l'appel, Allo envoie un événement webhook summary.updated.
Choisir un template
La plupart des appels n'ont qu'un seul résumé terminé, donc template_key peut être omis. Quand un appel en a plusieurs (par exemple MARKDOWN_CLASSIC et MARKDOWN_SHORT_CALL), template_key devient obligatoire : sinon la requête échoue avec 400 SUMMARY_TEMPLATE_KEY_REQUIRED.
| Template | Cas d'usage |
|---|---|
MARKDOWN_CLASSIC | Résumé structuré complet avec des sections |
MARKDOWN_SHORT_CALL | Résumé en un paragraphe pour les appels courts |
Si l'appel n'a aucun résumé terminé correspondant au template_key fourni, la requête renvoie 404 SUMMARY_TEMPLATE_NOT_FOUND.
Codes d'erreur
| Code | Statut | Quand |
|---|---|---|
INVALID_ITEM_ID | 400 | Le préfixe de l'ID n'est pas cll- |
INVALID_REQUEST_BODY | 400 | content est absent ou dépasse 100 000 caractères |
SUMMARY_TEMPLATE_KEY_REQUIRED | 400 | L'appel a plusieurs templates terminés et template_key a été omis |
CONVERSATION_ITEM_NOT_FOUND | 404 | L'appel n'existe pas, ou le propriétaire de l'API key n'y a pas accès |
SUMMARY_TEMPLATE_NOT_FOUND | 404 | Aucun résumé terminé n'existe pour le template_key demandé |