Allo

Modifier le résumé d'un appel

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

PATCH/v2/api/conversations/items/{id}/summary

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.

TemplateCas d'usage
MARKDOWN_CLASSICRésumé structuré complet avec des sections
MARKDOWN_SHORT_CALLRé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

CodeStatutQuand
INVALID_ITEM_ID400Le préfixe de l'ID n'est pas cll-
INVALID_REQUEST_BODY400content est absent ou dépasse 100 000 caractères
SUMMARY_TEMPLATE_KEY_REQUIRED400L'appel a plusieurs templates terminés et template_key a été omis
CONVERSATION_ITEM_NOT_FOUND404L'appel n'existe pas, ou le propriétaire de l'API key n'y a pas accès
SUMMARY_TEMPLATE_NOT_FOUND404Aucun résumé terminé n'existe pour le template_key demandé

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de chemin

idstringrequis

Call ID (cll-*)

Corps

contentstringrequis

Full replacement markdown content. Max 100,000 characters.

template_keyenum<string>

Required only when the call has more than one completed summary template.

MARKDOWN_CLASSICMARKDOWN_SHORT_CALL

Réponses

200Updated summary
dataobject
5 champs
idstring

Call ID this summary belongs to

contentstring | null

Markdown summary content

versioninteger<int64>

Optimistic-lock version. Increments on every successful update.

updated_atstring<date-time> | null
updated_byobject | null
2 champs
idstring
namestring | null
400
401
404
429