Skip to main content
Endpoint · POST /conversation/actions
Move a conversa para uma caixa de entrada ou para uma categoria. Exatamente um de mailbox | category, nunca ambos. Campos
  • mailbox — objeto { name } da caixa de entrada.
  • category — objeto { name } da categoria.
Em uma lista, este objeto vai no array actions de um POST /conversation/actions — veja Montar uma lista de ações.

Exemplo executável

Um assign_mailbox em uma conversa identificada por telefone e canal. Exatamente um de mailbox ou category, nunca ambos — e cada modo se comporta de forma diferente:
  • mailbox — atribui a conversa à caixa de entrada exata que você indica.
  • category — você não escolhe uma caixa: o sistema distribui a carga e atribui a conversa à caixa de entrada com menos chats pendentes dentro dessa categoria (útil para distribuir automaticamente entre uma equipe). A categoria deve ter pelo menos uma caixa de entrada configurada.

Request

Resposta

202 Accepted — o grupo foi aceito e roda em background. O resultado por ação não viaja na resposta (consulte-o depois — veja Como é executado).
string
Sempre processing: confirma que o grupo foi aceito e está em execução.
integer
Quantas ações do array foram admitidas para execução — não quantas tiveram sucesso.