Alterar estado da conversa

Endpoint · POST /conversation/actions

Duas ações alteram o estado (inbox_status) da conversa: mark_resolved a marca como resolvida e mark_pending como pendente. Nenhuma leva campos.

`mark_resolved`

Marca a conversa como resolvida.

{
  "type": "mark_resolved"
}

Se a conversa tem um AI employee atribuído e mídia recebida sem transcrever, mark_resolved pode falhar com TRANSCRIPTION_REQUIRED_TO_RESOLVE (guard de integridade): o AI monta seu prompt a partir do texto transcrito. Conversas atendidas por um humano não o disparam. Não escala para um humano: corrija e tente novamente.

`mark_pending`

Marca a conversa como pendente.

{
  "type": "mark_pending"
}

Em uma lista, estes objetos vão no array actions de um POST /conversation/actions — veja Montar uma lista de ações.

Exemplo executável

As ações mark_resolved e mark_pending em uma conversa identificada por telefone e canal. Nenhuma leva campos: apenas alteram o inbox_status.

Request

curl -X POST "https://app.1to1ai.com/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+525512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "mark_resolved"
      }
    ]
  }'

curl -X POST "https://app.1to1ai.com/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+525512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "mark_pending"
      }
    ]
  }'

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

{
  "status": "processing",
  "actions_accepted": 1
}

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.

Introdução

Conceitos

Guias

Ações

`mark_resolved`

`mark_pending`

Exemplo executável

Request

Resposta

​mark_resolved

​mark_pending

​Exemplo executável

​Request

​Resposta

`mark_resolved`

`mark_pending`

Exemplo executável

Request

Resposta