API2B REST API

A plataforma API2B fornece uma API REST escalável e de altíssimo desempenho para envio de mensagens, automação e integração de sistemas via WhatsApp.

Autenticação

Todas as requisições para a API devem ser autenticadas utilizando um token Bearer exclusivo (WaKey).

Onde encontrar sua chave: Acesse seu painel administrativo, vá em "Integração API > Tokens de Acesso" e gere uma nova WaKey.


                Headers:

                Content-Type: application/json

                Authorization: Bearer WaKey_z45c072f6263b2823e15761964a225a0

Endpoints Principais

POST `/api/v1/messages/send`

Envia uma mensagem de texto simples ou com formatações nativas do WhatsApp.

Payload (JSON)

{
  "number": "5511999999999",
  "text": "Olá, sua integração foi um sucesso! 🚀"
}

Retorno Esperado (202 Accepted)

{
  "status": "success",
  "message": "Mensagem aceita e colocada na fila de envio",
  "job_id": 142
}

Formatações de Texto Suportadas

Você pode utilizar os caracteres padrão do WhatsApp na sua propriedade text.

Efeito	Sintaxe API	Resultado Esperado no Aparelho
Negrito	`Seu texto aqui`	Seu texto aqui
Itálico	`_Seu texto aqui_`	Seu texto aqui
Tachado	`~Seu texto aqui~`	~~Seu texto aqui~~
Mono-espaçado	```código```	`código`
Quebra de linha	`\n` ou `\n\n`	Inicia um novo parágrafo.

Boas Práticas & O Que NÃO Fazer

O ecossistema do WhatsApp é rigoroso. Para garantir a longevidade do seu chip e número conectado na nossa API, siga estritamente as regras abaixo.

O QUE FAZER

Aqueça novos números: Durante os primeiros 7 dias, envie mensagens apenas para contatos que já interagiram com você.
Interatividade: Envie mensagens que instiguem a pessoa a responder (Ex: "Podemos confirmar sua agenda?"). Quanto mais pessoas te responderem, maior o "Trust Score" do seu chip na Meta.
Tratamento de Erros: Sempre armazene o `job_id` no seu sistema para consultas futuras.
Variabilidade de Texto: Ao fazer campanhas, use o recurso de Spintax para que cada cliente receba uma saudação ligeiramente diferente (Ex: Olá, Oi, Bom dia).

O QUE NÃO FAZER

Envios em Massa Imediatos: Nunca pegue uma lista de 500 números frios e dispare no mesmo segundo via API. O risco de banimento é de 99%.
Links Clicáveis para Desconhecidos: O WhatsApp não transforma links em azul caso a pessoa não tenha o seu número salvo. Evite mandar links na primeira mensagem de prospecção fria.
Spam ou Denúncias: Se muitos usuários apertarem o botão "Denunciar / Bloquear", a Meta bloqueará o chip instantaneamente. Seja ético e relevante.
Ignorar Respostas: Utilizar a API apenas para enviar sem interagir é um comportamento forte de bot de spam.

Aviso sobre Throttle (Rate Limit): Nossa API é desenhada de forma assíncrona. Ela aceitará 10.000 requisições simultâneas e retornará sucesso imediato, colocando-as em fila. Porém, nossos Daemons enviarão na cadência de segurança do seu servidor (padrão de 5 a 10 segundos) para simular um humano digitando e evitar bloqueios severos no seu chip.

Documentação API