Allo

Trouver un fil de discussion

Recherche le fil attaché à un élément de conversation. Passez le type de l'élément dans entity type ( CALL , TEXT MESSAGE ou CONVERSATION NOTE ) et son ID…

GET/v2/api/threads

Comportement

Recherche le fil attaché à un élément de conversation. Passez le type de l'élément dans entity_type (CALL, TEXT_MESSAGE ou CONVERSATION_NOTE) et son ID dans entity_id (cll-*, msg-* ou not-*).

Chaque élément ayant au maximum un fil, data contient zéro ou un fil. Un tableau data vide signifie que l'élément existe mais n'a pas encore de fil — créez-en un avec POST /v2/api/threads.

Erreurs

StatutCodeQuand
400INVALID_THREAD_ENTITY_TYPEentity_type n'est pas l'un de CALL, TEXT_MESSAGE, CONVERSATION_NOTE
404CONVERSATION_ITEM_NOT_FOUNDAucun élément de conversation avec cet entity_id

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de requête

entity_typeenum<string>requis

Type of the conversation item

CALLTEXT_MESSAGECONVERSATION_NOTE

entity_idstringrequis

ID of the conversation item (cll-*, msg-*, or not-*)

Réponses

200The item's thread, or an empty list if none exists
dataobject[]
10 champs
idstring

Thread ID (cth-*)

entity_typeenum<string>

Type of the conversation item the thread is attached to.

CALLTEXT_MESSAGECONVERSATION_NOTE

entity_idstring

ID of the conversation item (cll-*, msg-*, or not-*).

contact_numberstring

The contact's phone number (E.164).

resolvedboolean
resolved_atstring<date-time> | null
resolved_byobject

Author of a note or comment.

2 champs
idstring
namestring | null
comment_countinteger
created_atstring<date-time>
commentsobject[]
6 champs
idstring

Comment ID (thc-*)

contentstring

Comment text, with mentions inline as @[Name](usr-...).

userobject

Author of a note or comment.

2 champs
idstring
namestring | null
mentionsobject[]
3 champs
user_idstring
namestring | null
deletedboolean

true if the mentioned user has since been removed from the team.

created_atstring<date-time>
updated_atstring<date-time>
400
401
404
429