Enviar WhatsApp com PHP e cURL: exemplo de API (Guzzle e Laravel)

cURL

curl -X POST https://api.zapzapapi.com/api/v1/SEU_INSTANCE_ID/send/text \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"number":"5511999999999","text":"Olá! Teste de envio pela API."}'

PHP (cURL)

<?php
function zapzap_post(string $caminho, array $dados): array {
    $instancia = getenv('ZAPZAP_INSTANCE_ID');
    $ch = curl_init("https://api.zapzapapi.com/api/v1/$instancia$caminho");
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT        => 30,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'x-api-key: ' . getenv('ZAPZAP_API_KEY'),
            'x-api-secret: ' . getenv('ZAPZAP_API_SECRET'),
        ],
        CURLOPT_POSTFIELDS     => json_encode($dados, JSON_UNESCAPED_UNICODE),
    ]);
    $corpo = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $erro = curl_error($ch);
    curl_close($ch);
    if ($corpo === false) {
        throw new RuntimeException("Falha de rede: $erro");
    }
    return ['status' => $status, 'corpo' => json_decode($corpo, true)];
}

$r = zapzap_post('/send/text', [
    'number' => '5511999999999',
    'text'   => 'Olá! Seu pedido saiu para entrega.',
]);
print_r($r);

PHP (Guzzle)

<?php
use GuzzleHttp\Client;

$http = new Client([
    'base_uri' => 'https://api.zapzapapi.com/api/v1/' . getenv('ZAPZAP_INSTANCE_ID') . '/',
    'headers'  => [
        'x-api-key'    => getenv('ZAPZAP_API_KEY'),
        'x-api-secret' => getenv('ZAPZAP_API_SECRET'),
    ],
    'timeout'     => 30,
    'http_errors' => false,
]);

$r = $http->post('send/media', ['json' => [
    'number'  => '5511999999999',
    'type'    => 'document',
    'file'    => 'https://seusite.com/arquivos/proposta.pdf',
    'docName' => 'Proposta.pdf',
    'text'    => 'Segue a proposta.',
]]);
echo $r->getStatusCode(), ' ', $r->getBody();

PHP (Laravel)

<?php
namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Support\Facades\Http;

class EnviarWhatsApp implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable;

    public int $tries = 4;
    public array $backoff = [10, 60, 300];

    public function __construct(public string $numero, public string $texto) {}

    public function handle(): void
    {
        $cfg = config('services.zapzap');
        $r = Http::withHeaders([
                'x-api-key'    => $cfg['key'],
                'x-api-secret' => $cfg['secret'],
            ])
            ->timeout(20)
            ->post("https://api.zapzapapi.com/api/v1/{$cfg['instance']}/send/text", [
                'number' => $this->numero,
                'text'   => $this->texto,
            ]);

        if ($r->clientError()) {
            $this->fail(new \RuntimeException('ZapZap ' . $r->status() . ' ' . $r->body()));
            return;
        }
        $r->throw(); // 5xx: o Laravel repete conforme o backoff
    }
}

// Uso: EnviarWhatsApp::dispatch('5511999999999', 'Seu pedido foi enviado.');

PHP (puro)

<?php
$raw = file_get_contents('php://input');
$evento = json_decode($raw, true);

http_response_code(200); // confirma primeiro
header('Content-Length: 0');
if (function_exists('fastcgi_finish_request')) {
    fastcgi_finish_request(); // libera a resposta e continua o trabalho
}

$msg = $evento['data']['message'] ?? null;
if (($evento['event'] ?? '') !== 'messages' || !$msg || !empty($msg['fromMe'])) {
    exit;
}
error_log('mensagem de ' . ($msg['chatid'] ?? '?') . ': ' . ($msg['text'] ?? ''));