CONNECT · API 0.2
Conecte qualquer app.
Uma API independente para integrar seus sistemas atuais e futuros ao WhatsApp. Projetos organizam as instâncias; cada instância tem sua sessão, seus destinos de webhook e suas credenciais.
Comece por aqui
- Crie um projeto e uma instância no painel.
- Conecte o WhatsApp pelo QR Code.
- Crie uma chave exclusiva para seu sistema em Integrações.
- Configure um webhook HTTPS e verifique a assinatura.
- Envie mensagens com uma chave de idempotência e acompanhe as confirmações.
Integrar qualquer sistema →
Exemplos em JavaScript, Python e receptor de webhook com verificação de assinatura.
Referência da API →
Rotas, autenticação, contratos de mídia, callbacks, filtros, limites e erros.
Instalação, backup e operação →
Execução local, preparação de servidor HTTPS, recuperação de sessão e tratamento de falhas.
Roteiro de homologação da Lola →
Primeira instância real para conferir envio, recebimento e confirmação de mídias.
Ferramentas para integração
Um envio simples
POST /api/instances/INSTANCE_ID/messages
Authorization: Bearer TOKEN_DO_SISTEMA
Content-Type: application/json
Idempotency-Key: operacao-unica-001
{
"phone": "5511999999999",
"type": "text",
"text": "Mensagem de teste"
}A resposta contém o ID local e o ID WhatsApp reservado. A aceitação na fila não é confirmação de entrega. Acompanhe os status enviado, entregue, lido e reproduzido quando o WhatsApp os disponibilizar.
API própria e documentada
Use os contratos documentados para integrar seu sistema. Operações indisponíveis retornam erro explícito. Apps na nuvem precisam de um endereço HTTPS público; 127.0.0.1 funciona somente neste computador.
Versão em homologação. Não afiliado à Meta. As chaves devem ficar no backend do seu sistema.