Skip to main content
PUT
Execute conversation action
Scope requis : CONVERSATIONS_WRITE

Actions disponibles

Passer une action non prise en charge renvoie une erreur 400 avec le code INVALID_ACTION.

Idempotence

Toutes les actions sont idempotentes — appeler READ sur une conversation déjà lue est un no-op et renvoie 200. Cet endpoint prend également en charge l’en-tête Idempotency-Key. Voir Idempotence.

Ciblage d’une ligne

Omettez allo_number pour appliquer l’action sur tous les numéros Allo. Fournissez-le pour cibler l’action sur une ligne spécifique.

Autorisations

Authorization
string
header
requis

Paramètres de chemin

contact_number
string
requis

The external phone number in E.164 format. URL-encode the + as %2B.

Exemple:

"+14155551234"

Corps

application/json
action
enum<string>
requis

The action to execute.

Options disponibles:
READ,
UNREAD,
ARCHIVE,
UNARCHIVE
allo_number
string

Scope the action to a specific Allo number (E.164). Without this, the action applies across all lines.

Exemple:

"+14155550100"

Réponse

Action executed successfully