/connections

Lista os números de WhatsApp conectados à organização. É daqui que sai o connection_id que todos os endpoints de envio pedem.

Escopo necessário: agents:read. Limite: 120 requisições por minuto.

Endpoints

Método	Rota	Devolve
GET	`/connections`	Lista de números conectados
GET	`/connections/{id}`	Uma conexão

Aceita o filtro agent_id para ver só os números ligados a um agente.

Exemplo

curl "https://api.wevi.chat/functions/v1/connections" \
  -H "Authorization: Bearer wevi_SUA_CHAVE"

const res = await fetch("https://api.wevi.chat/functions/v1/connections", {
  headers: { Authorization: "Bearer wevi_SUA_CHAVE" },
});
const { data } = await res.json();
const connectionId = data[0].id;

Objeto da conexão

{
  "id": "dddd0000-0000-4000-8000-0000000000aa",
  "display_name": "Clínica OdontoVita",
  "phone_number": "+55 11 91234-5678",
  "phone_number_id": "123456789012345",
  "waba_id": "987654321098765",
  "verified_name": "Clínica OdontoVita",
  "quality_rating": "GREEN",
  "agent_id": "dddd0000-...",
  "connected_via": "embedded_signup",
  "is_coexistence": false,
  "catalog_id": null,
  "config_error": null,
  "subscribed_at": "2026-06-12T12:00:00Z",
  "created_at": "2026-06-12T11:58:00Z"
}

quality_rating é a nota que a Meta dá ao número: GREEN, YELLOW ou RED. Vermelho costuma vir antes de uma limitação de envio, então vale monitorar.

config_error traz problema de configuração do número detectado nos últimos envios, com mensagem e horário. Vem null quando está tudo certo.

O que não sai daqui

Token de acesso, app secret, verify token e as chaves de Flow nunca aparecem na resposta, mesmo para chave com todos os escopos. São credenciais da sua conta na Meta e ficam só no servidor.

/templates

→