API Conecta — Guia de Integração

Plataforma multiempresa de mensageria WhatsApp, CRM e webhooks. Cada empresa (tenant) possui chaves de API próprias e isolamento total de dados.

Observação: o conector WhatsApp atual é não oficial — podem ocorrer limitações do provedor. Aceite HTTP não é comprovante de entrega; use os recibos/webhooks.

1. Autenticação

Todas as rotas de negócio exigem chave de API gerada no painel (/entrar → Console → Chaves):

curl -H "X-API-Key: SUA_CHAVE" https://apiconecta.com.br/console/devices

2. Health checks

GET /health/live   → 200 se o processo está vivo
GET /health/ready  → 200 se pronto para receber tráfego

3. Sessão e login do painel

POST /auth/login       { "email": "...", "password": "..." }
GET  /auth/session     sessão atual (cookie)
POST /auth/logout

4. Webhooks

Eventos de mensagem e status são entregues ao URL cadastrado por tenant. Implemente um endpoint HTTP POST e valide a assinatura HMAC enviada no header antes de processar.

5. Exemplos

# Python
import requests
r = requests.get("https://apiconecta.com.br/console/devices",
                 headers={"X-API-Key": "SUA_CHAVE"})
print(r.json())
// Node.js
const r = await fetch("https://apiconecta.com.br/console/devices",
  { headers: { "X-API-Key": "SUA_CHAVE" } });
console.log(await r.json());

Documentação OpenAPI completa disponível sob solicitação (Swagger interno permanece restrito). Última atualização: 03/11/2026.