Por que usar a API própria nesse caso
A maior parte dos sistemas de gestão no Brasil é PHP. Chamar a API direto do sistema que já existe evita criar um middleware só para WhatsApp.
Passo a passo
- Guarde a chave em variável de ambiente ou em arquivo fora do public_html.
- Monte a função enviar() com cURL, timeout e checagem de código HTTP.
- Trate 429 com sleep e nova tentativa — a fila protege o chip, então recusar é comportamento esperado.
- Para o webhook, leia php://input, valide a assinatura e responda 200 antes de processar.
Exemplo de código
<?php
function wacore_enviar(string $numero, string $texto, string $instancia = 'principal'): array {
$ch = curl_init('https://wacoreapi.zapboot.com/v1/messages/text');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_HTTPHEADER => ['content-type: application/json', 'apikey: ' . getenv('WACORE_KEY')],
CURLOPT_POSTFIELDS => json_encode([
'instance' => $instancia,
'number' => preg_replace('/\D/', '', $numero),
'text' => $texto,
], JSON_UNESCAPED_UNICODE),
]);
$out = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($code >= 300) throw new RuntimeException("WACore $code: $out");
return json_decode($out, true);
}
Duas dicas que evitam retrabalho
- Se o seu servidor não abre conexão externa, verifique se o cURL está liberado no firewall da hospedagem.
- json_encode com JSON_UNESCAPED_UNICODE mantém acento legível no log e evita texto estranho no painel.
Contrato da API: todos os campos, códigos de erro e limites estão em /api. Se você precisa do mesmo endpoint em outra linguagem, a chamada é a mesma — muda só o cliente HTTP.
Como contratar
A contratação é sob consulta. Descreva o cenário (quantos números, volume e qual sistema integra) e receba a proposta com prazo de instalação e chave de API.