Visão geral
i
O que esta API faz
Recebe número e mensagem, valida token e registra/processa o envio pela instância permitida.
Para desenvolvedores
Use o endpoint send e envie Authorization: Bearer.
Para painéis (HubSoft / SGP)
Use os manuais no final desta página.
Endpoints corretos
| Uso | Endpoint | Quando usar |
|---|---|---|
| Dev / HubSoft | https://lethallhost.com.br/api/whatsapp/v1/public/send | Integração por código e mensageiro do HubSoft |
| SGP | https://lethallhost.com.br/api/whatsapp/v1/public/send | Usar no modo HTTP Genérico com JSON e Authorization Bearer |
Guia Dev (principal)
Autenticação
Preferência: header Authorization: Bearer SEU_TOKEN
| Prioridade | Local | Campo |
|---|---|---|
| 1 | Header | Authorization: Bearer |
| 2 | Body/Query | token / apikey |
Parâmetros
Campos obrigatórios + opcionais mais usados
| Campo | Obrigatório | Aliases |
|---|---|---|
| to | Sim | numero, number, phone |
| message | Sim | mensagem, msg, text |
| instance_id | Não | instancia, instance |
| agendamento | Não | Recomendado: sim |
Exemplos prontos
Os exemplos abaixo são os mais usados em produção. Copie e troque o token/número.
1) POST JSON (recomendado)
curl -X POST "https://lethallhost.com.br/api/whatsapp/v1/public/send" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
"to": "5561999999999",
"message": "Olá! Teste Lethall Hub (JSON).",
"instance_id": 1,
"agendamento": "sim"
}'
2) POST FORM (x-www-form-urlencoded)
curl -X POST "https://lethallhost.com.br/api/whatsapp/v1/public/send" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "Content-Type: application/x-www-form-urlencoded; charset=utf-8" \
--data-urlencode "numero=5561999999999" \
--data-urlencode "mensagem=Teste Lethall Hub (FORM)" \
--data-urlencode "instance_id=1" \
--data-urlencode "agendamento=sim"
3) JavaScript (fetch)
async function lethallHubSend() {
const url = "https://lethallhost.com.br/api/whatsapp/v1/public/send";
const payload = {
to: "5561999999999",
message: "Teste Lethall Hub (fetch).",
instance_id: 1,
agendamento: "sim"
};
const r = await fetch(url, {
method: "POST",
headers: {
"Authorization": "Bearer SEU_TOKEN_AQUI",
"Content-Type": "application/json; charset=utf-8"
},
body: JSON.stringify(payload)
});
const data = await r.json().catch(() => null);
console.log(r.status, data);
return { status: r.status, data };
}
Respostas HTTP
| Status | Significado | Ação |
|---|---|---|
| 200 | Envio aceito / registrado | OK |
| 202 | Fila (instância indisponível) | Aguarde / mantenha agendamento=sim |
| 401 | Token ausente/inválido | Corrigir token |
| 403 | Sem permissão/instância | Validar permissões do token |
| 406 | Bloqueio de segurança | Teste payload simples |
Exemplos de retorno
200
{"ok":true,"id":1421,"status":"queued","message":"Mensagem na fila."}
202
{"ok":false,"error":"instance_not_online","instance_status":"qrcode","queue_id":456}
401
{"ok":false,"error":"missing_token"}
403
{"ok":false,"error":"instance_not_allowed"}
406
{"ok":false,"error":"not_acceptable_modsecurity"}
Boas práticas rápidas
• Número no padrão 55DDDNUMERO
• Comece com mensagem simples
• Prefira POST JSON em produção
• Não exponha token em prints
Manual HubSoft (passo a passo)
✓
HubSoft usa o endpoint DEV
Use https://lethallhost.com.br/api/whatsapp/v1/public/send e variáveis [[numero]] / [[mensagem]].
Passo a passo
- Abra Integrações → SMS / Mensageiros.
- Selecione Gateway de SMS: Outros.
- Crie/edite uma integração e preencha os parâmetros abaixo.
- Salve e faça um teste.
Parâmetros (modelo)
| Parâmetro | Valor |
|---|---|
| url | https://lethallhost.com.br/api/whatsapp/v1/public/send |
| numero | [[numero]] |
| mensagem | [[mensagem]] |
| agendamento | sim |
| token | SEU_TOKEN_REAL |
| key | Opcional (key public) |
| incluirAcentos | Opcional |
| limiteCaracteres | Opcional |
Importante: HubSoft usa colchetes duplos: [[numero]] e [[mensagem]].
Manual SGP (HTTP Genérico)
✓
Formato oficial do SGP
Use o gateway HTTP Genérico com a URL oficial abaixo.
Passo a passo
- Abra o SGP e vá em Administração → SMS Gateway.
- Em Gateway, selecione HTTP Genérico.
- No campo Config, cole o JSON abaixo.
- Troque SEU_TOKEN_AQUI pelo token real.
- Marque Ativo e salve.
Endpoint oficial
https://lethallhost.com.br/api/whatsapp/v1/public/send
Config oficial (JSON)
{
"url": "https://lethallhost.com.br/api/whatsapp/v1/public/send",
"timeout": 60,
"do_post": 1,
"request_json": 1,
"ignore_errors": 0,
"headers": {
"Authorization": "Bearer SEU_TOKEN_AQUI",
"Content-Type": "application/json",
"User-Agent": "Mozilla/5.0"
},
"set_to": "to",
"set_msg": "message"
}
Área administrativa protegida.
Entre como admin para visualizar a configuração antiga de testes.
Entrar como admin
Entre como admin para visualizar a configuração antiga de testes.
Entrar como admin
Checklist: Gateway em HTTP Genérico, URL oficial correta, envio JSON e header Authorization Bearer.
Suporte
Portal:
https://lethallhost.com.br/clientes/index.php/login
Ao abrir chamado, envie: data/hora do teste, status HTTP, retorno e print sem token.