API Externa

Envie mensagens via WhatsApp Cloud API

A API Externa permite que voce envie mensagens WhatsApp diretamente do seu sistema, automacao (n8n, Make, Zapier) ou qualquer ferramenta que faca chamadas HTTP. Usa a Cloud API oficial da Meta com coexistencia.

Quick Start

1Acesse Configuracoes > API & Integracoes no app e gere sua API Key
2Certifique-se de ter uma instancia Cloud API configurada e conectada
3Cole sua API Key abaixo e preencha os campos para testar direto na documentacao

Autenticacao

Todos os endpoints da API Externa requerem autenticacao via API Key. Voce pode enviar a chave de 3 formas:

Header (recomendado)

X-API-Key: lf_...

Authorization

Bearer lf_...

Query Param

?api_key=lf_...

Configuracao

URL Base

http://localhost:3001

Sua API Key

Usada em todos os testes abaixo. Nao e armazenada.

Endpoints

POST/api/v1/send-messageAPI Key

Envia uma mensagem de texto simples para um numero WhatsApp.

Body Parameters

phonestringobrigatorio

Numero com codigo do pais (ex: 5511999999999)

messagestringobrigatorio

Texto da mensagem a ser enviada

instance_idstringopcional

ID da instancia Cloud API. Se nao informado, usa a primeira disponivel.

curl -X POST http://localhost:3001/api/v1/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_API_KEY" \
  -d '{}'

Respostas

200Mensagem enviada com sucesso

400Campos obrigatorios ausentes

401API Key invalida

502Erro na Cloud API da Meta

Dica: Integracao com n8n

No n8n, use o node HTTP Request com as seguintes configuracoes:

Method: POST
URL: http://localhost:3001/api/v1/send-message
Authentication: Header Auth
Header Name: X-API-Key
Header Value: sua API Key
Body Content Type: JSON

Body JSON:

{
  "phone": "{{ $json.phone }}",
  "message": "{{ $json.message }}"
}