Números, equipes e etiquetas

Números de WhatsApp

GET /v1/c/{slug}/channels · Escopos: workspace:read · campaigns:write · messages:send_template · templates:read

Os números da empresa, com a qualidade e o limite diário que a Meta deu a cada um.

Parâmetros do endereço

Campo	Detalhes
`slug`	O identificador da empresa no DoneTalk (o mesmo da chave).

Exemplo de pedido

curl -X GET "https://api.donetalk.com/v1/c/demo/channels" \
  -H "Authorization: Bearer $DONETALK_KEY"

Resposta 200

{
  "channels": [
    {
      "id": "01a0cccc-0000-7000-8000-000000000002",
      "name": "Captei",
      "phone": "554896429898",
      "status": "active",
      "quality": "GREEN",
      "messagingTier": "TIER_1K",
      "account": {
        "id": "01a0cccc-0000-7000-8000-000000000001",
        "name": "Captei WABA"
      },
      "currency": "BRL",
      "handling": {
        "mode": "flow",
        "teamId": "01a0cb22-89c0-7e02-b96b-3f4731dde701",
        "flowId": "01a0d60a-3fc1-7df5-a07c-9769fd5701e6",
        "assistantId": null
      },
      "createdAt": "2026-09-22T20:14:21.670Z"
    }
  ]
}

Erros possíveis

401 unauthorized
403 insufficient_scope
422 validation_failed
429 rate_limited

Equipes

GET /v1/c/{slug}/teams · Escopos: workspace:read · campaigns:write

Para mandar as respostas de uma campanha à equipe certa (reply.id).

Parâmetros do endereço

Campo	Detalhes
`slug`	O identificador da empresa no DoneTalk (o mesmo da chave).

Exemplo de pedido

curl -X GET "https://api.donetalk.com/v1/c/demo/teams" \
  -H "Authorization: Bearer $DONETALK_KEY"

Resposta 200

{
  "teams": [
    {
      "id": "01a0cb22-89c0-7e02-b96b-3f4731dde701",
      "name": "Vendas",
      "description": null,
      "isActive": true,
      "distributionMode": "least_busy",
      "businessHoursId": null,
      "members": [
        {
          "id": "01a0cac1-4a6f-7646-b5f8-c1d19090016a",
          "name": "Tayomara Batista",
          "presence": "online"
        }
      ]
    }
  ]
}

Erros possíveis

401 unauthorized
403 insufficient_scope
422 validation_failed
429 rate_limited

Etiquetas

GET /v1/c/{slug}/tags · Escopos: workspace:read · contacts:read

Parâmetros do endereço

Campo	Detalhes
`slug`	O identificador da empresa no DoneTalk (o mesmo da chave).

Exemplo de pedido

curl -X GET "https://api.donetalk.com/v1/c/demo/tags" \
  -H "Authorization: Bearer $DONETALK_KEY"

Resposta 200

{
  "tags": [
    {
      "id": "01a12150-3610-7c00-b680-188c2b4c7313",
      "name": {
        "pt-BR": "VIP",
        "en": "VIP",
        "es": "VIP"
      },
      "color": "#92400e",
      "appliesTo": "both",
      "isActive": true,
      "contacts": 128,
      "conversations": 40
    }
  ]
}

Erros possíveis

401 unauthorized
403 insufficient_scope
422 validation_failed
429 rate_limited

Desfechos

GET /v1/c/{slug}/outcomes · Escopos: workspace:read · conversations:read · conversations:write

Como um atendimento pode ser concluído (venda, sem interesse, resolvido…), com o código usado em close e nos avisos.

Parâmetros do endereço

Campo	Detalhes
`slug`	O identificador da empresa no DoneTalk (o mesmo da chave).

Exemplo de pedido

curl -X GET "https://api.donetalk.com/v1/c/demo/outcomes" \
  -H "Authorization: Bearer $DONETALK_KEY"

Resposta 200

{
  "outcomes": [
    {
      "id": "01a0cb22-0000-7000-8000-00000000000a",
      "code": "converted",
      "label": {
        "pt-BR": "Venda",
        "en": "Sale",
        "es": "Venta"
      },
      "category": "success",
      "is_success": true,
      "requires_note": false,
      "reopen_allowed": true,
      "sort": 1
    }
  ]
}

Erros possíveis

401 unauthorized
403 insufficient_scope
422 validation_failed
429 rate_limited

Esta página em Markdown