API de integração do Atendai

# <marca>_api_<8 letras ou números>_<43 caracteres>
Authorization: Bearer atendai_api_ab12cd34_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Authorization: Bearer $CHAVE
Content-Type: application/json
Idempotency-Key: pedido-2026-10-12-0001

curl -sS "https://app.atendai.pro/api/v1/health" \
  -H "Authorization: Bearer $CHAVE"

const r = await fetch("https://app.atendai.pro/api/v1/health", {
  headers: { Authorization: `Bearer ${process.env.CHAVE}` },
});
console.log(await r.json());

import os, requests
r = requests.get("https://app.atendai.pro/api/v1/health",
                 headers={"Authorization": f"Bearer {os.environ['CHAVE']}"})
print(r.json())

{
  "status": "ok",
  "versao": "1",
  "escritorio_id": "8f1c…",
  "canais": [
    { "id": "6e68…", "nome": "Comercial", "estado": "conectado" }
  ]
}

curl -sS -X POST "https://app.atendai.pro/api/v1/whatsapp/texto" \
  -H "Authorization: Bearer $CHAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: texto-0001-2026-10-12" \
  -d '{
    "conversa_id": "0b6d1f2e-…",
    "texto": "Olá, seu pedido teve andamento."
  }'

const r = await fetch("https://app.atendai.pro/api/v1/whatsapp/texto", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHAVE}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "texto-0001-2026-10-12",
  },
  body: JSON.stringify({
    conversa_id: "0b6d1f2e-…",
    texto: "Olá, seu pedido teve andamento.",
  }),
});
console.log(r.status, await r.json());

import os, requests
r = requests.post(
    "https://app.atendai.pro/api/v1/whatsapp/texto",
    headers={"Authorization": f"Bearer {os.environ['CHAVE']}",
             "Idempotency-Key": "texto-0001-2026-10-12"},
    json={"conversa_id": "0b6d1f2e-…",
          "texto": "Olá, seu pedido teve andamento."})
print(r.status_code, r.json())

{
  "mensagem_id": "a41c…",
  "conversa_id": "0b6d…",
  "estado": "enviada",
  "wamid": "wamid.HBgM…",
  "responsavel": { "tipo": "ia" }
}

curl -sS -X POST "https://app.atendai.pro/api/v1/whatsapp/template" \
  -H "Authorization: Bearer $CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "canal_id": "6e6834d2-…",
    "telefone_e164": "+5511999998888",
    "nome": "Maria Silva",
    "template": "aviso_audiencia",
    "idioma": "pt_BR",
    "corpo": ["Maria", "15/10 às 14h"],
    "chave_idempotencia": "tpl-0001-2026-10-12"
  }'

await fetch("https://app.atendai.pro/api/v1/whatsapp/template", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.CHAVE}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    canal_id: "6e6834d2-…",
    telefone_e164: "+5511999998888",
    nome: "Maria Silva",
    template: "aviso_audiencia",
    idioma: "pt_BR",
    corpo: ["Maria", "15/10 às 14h"],
    chave_idempotencia: "tpl-0001-2026-10-12",
  }),
});

requests.post(
    "https://app.atendai.pro/api/v1/whatsapp/template",
    headers={"Authorization": f"Bearer {os.environ['CHAVE']}"},
    json={"canal_id": "6e6834d2-…", "telefone_e164": "+5511999998888",
          "nome": "Maria Silva", "template": "aviso_audiencia",
          "idioma": "pt_BR", "corpo": ["Maria", "15/10 às 14h"],
          "chave_idempotencia": "tpl-0001-2026-10-12"})

curl -sS -X POST "https://app.atendai.pro/api/v1/whatsapp/imagem" \
  -H "Authorization: Bearer $CHAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: img-0001-2026-10-12" \
  -d '{
    "conversa_id": "0b6d1f2e-…",
    "imagem_url": "https://exemplo.com.br/comprovante.jpg",
    "legenda": "Segue o comprovante."
  }'

curl -sS "https://app.atendai.pro/api/v1/whatsapp/template?chave=texto-0001-2026-10-12" \
  -H "Authorization: Bearer $CHAVE"

curl -sS "https://app.atendai.pro/api/v1/conversas/0b6d1f2e-…" \
  -H "Authorization: Bearer $CHAVE"

{
  "id": "0b6d…",
  "estado": "aguardando",
  "canal_id": "6e68…",
  "contato": { "id": "c912…", "nome": "Maria Silva", "telefone": "+5511999998888" },
  "responsavel": { "tipo": "fila", "id": "7a10…" },
  "etiquetas": ["Urgente"],
  "criada_em": "2026-10-10T12:00:00Z",
  "ultima_entrada_em": "2026-10-11T09:00:00Z",
  "atualizada_em": "2026-10-11T09:01:00Z"
}

curl -sS "https://app.atendai.pro/api/v1/conversas/0b6d1f2e-…/mensagens?limite=50" \
  -H "Authorization: Bearer $CHAVE"

# próxima página: o proximo_antes da resposta anterior
curl -sS "https://app.atendai.pro/api/v1/conversas/0b6d1f2e-…/mensagens?limite=50&antes=9c41b7e0-…" \
  -H "Authorization: Bearer $CHAVE"

const base = "https://app.atendai.pro/api/v1/conversas/0b6d1f2e-…/mensagens";
let antes = null;
do {
  const url = base + "?limite=100" + (antes ? `&antes=${antes}` : "");
  const r = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.CHAVE}` },
  });
  const pagina = await r.json();
  for (const m of pagina.mensagens) console.log(m.em, m.direcao, m.texto);
  antes = pagina.proximo_antes;
} while (antes);

import os, requests
base = "https://app.atendai.pro/api/v1/conversas/0b6d1f2e-…/mensagens"
antes = None
while True:
    params = {"limite": 100}
    if antes:
        params["antes"] = antes
    r = requests.get(base, params=params,
                     headers={"Authorization": f"Bearer {os.environ['CHAVE']}"})
    pagina = r.json()
    for m in pagina["mensagens"]:
        print(m["em"], m["direcao"], m["texto"])
    antes = pagina["proximo_antes"]
    if not antes:
        break

{
  "conversa_id": "0b6d…",
  "mensagens": [
    {
      "id": "5d2a…",
      "direcao": "saida",
      "tipo": "texto",
      "texto": "Olá, seu pedido teve andamento.",
      "em": "2026-10-11T09:01:00Z",
      "status": "lida",
      "origem": "integracao",
      "erro_meta": null
    },
    {
      "id": "9c41…",
      "direcao": "entrada",
      "tipo": "texto",
      "texto": "Bom dia, alguma novidade?",
      "em": "2026-10-11T09:00:00Z",
      "status": "entregue",
      "origem": "contato",
      "erro_meta": null
    }
  ],
  "proximo_antes": "9c41…"
}

curl -sS -X POST "https://app.atendai.pro/api/v1/conversas/nota" \
  -H "Authorization: Bearer $CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "conversa_id": "0b6d1f2e-…",
    "nota": "Cliente pediu retorno amanhã.",
    "chave_idempotencia": "nota-0001-2026-10-12"
  }'

{ "conversa_id": "0b6d…", "contato_id": "c912…", "nota_id": "e7f0…" }

curl -sS -X POST "https://app.atendai.pro/api/v1/conversas/etiquetas" \
  -H "Authorization: Bearer $CHAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: etq-0001-2026-10-12" \
  -d '{ "conversa_id": "0b6d1f2e-…", "etiquetas": ["Urgente"] }'

{
  "erro": "VALIDACAO",
  "mensagem": "Algum campo está inválido.",
  "erros_campos": [
    { "campo": "texto", "motivo": "valor inválido" }
  ]
}