Ir para o conteúdo
WACore api
Entrar
CódigoLaravel

WhatsApp no Laravel com Service e Queue

No Laravel o jeito certo é um Service com a chamada HTTP e um Job na fila — assim o envio não trava a requisição do usuário e o retry do próprio framework cuida do 429.

Por que usar a API própria nesse caso

Laravel já tem fila, retry, backoff e log. Usar isso em vez de tentar na hora deixa o checkout e o cadastro instantâneos, mesmo com 500 mensagens na frente.

Passo a passo

  1. Adicione WACORE_KEY e WACORE_URL em config/services.php e no .env.
  2. Crie um Job SendWhatsapp (ShouldQueue) com tries=3 e backoff [10, 30, 60].
  3. No service, use Http::withHeaders([...])->post(...) e lance exceção em falha para o job tentar de novo.
  4. Dispare SendWhatsapp::dispatch($phone, $text) de qualquer controller ou listener.

Exemplo de código

<?php
namespace App\Jobs;

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

class SendWhatsapp implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;
    public array $backoff = [10, 30, 60];

    public function __construct(public string $phone, public string $text) {}

    public function handle(): void
    {
        $res = Http::withHeaders(['apikey' => config('services.wacore.key')])
            ->timeout(15)
            ->post(config('services.wacore.url') . '/v1/messages/text', [
                'instance' => config('services.wacore.instance'),
                'number'   => preg_replace('/\D/', '', $this->phone),
                'text'     => $this->text,
            ]);

        if ($res->status() === 429) {
            $this->release(30);
            return;
        }
        $res->throw();
    }
}

Duas dicas que evitam retrabalho

  • Rode queue:work com --tries=3 e use Horizon se o volume passar de mil por dia.
  • Nunca chame HTTP dentro de uma transação de banco aberta: a conexão fica presa esperando rede.
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.

Ver planos