API do WhatsApp: veja como enviar mensagens e notificações com PHP

API do WhatsApp é a escolha perfeita quando o assunto é notificar clientes em tempo real.
Logo de início, vale mencionar que você precisará do PHP 8.1 ou superior para usar o
SDK oficial da APIBrasil. Entretanto, caso prefira outras linguagens, existem alternativas;
todavia, este tutorial foca exclusivamente em PHP para manter o passo a passo direto.

O que veremos neste tutorial

1. Por que adotar a API do WhatsApp?
2. Pré‑requisitos e instalação do SDK
3. Criando o arquivo notification.php
4. Obtendo credenciais na APIBrasil
5. Analisando o código linha a linha
6. Testando no terminal
7. Limites do plano gratuito
8. Webhooks e socket.io
9. Boas práticas de produção
10. Segurança e links úteis
11. Perguntas frequentes (FAQ)

1. Por que adotar a API do WhatsApp?

Para começar, o WhatsApp tem mais de 2 bilhões de usuários ativos; portanto,
usar a API oficial aumenta a taxa de abertura de mensagens em comparação
com SMS ou e‑mail. Além disso, a APIBrasil simplifica o processo de
conexão do seu dispositivo, permitindo envios programáticos com poucos
endpoints REST. Consequentemente, seu time reduz a carga operacional
e ganha escala rapidamente.

2. Pré‑requisitos e instalação do SDK

Antes de mais nada, confirme se o ambiente atende aos itens abaixo:

• PHP 8.1 ou superior (downloads oficiais);
• Composer instalado (guia rápido);
• Conta ativa na APIBrasil;
• Dois tokens: DeviceToken e BearerToken.

Em seguida, instale o SDK com:

composer require jhowbhz/apigratis-sdk-php

3. Criando o arquivo notification.php

Logo depois, crie notification.php; será nele que enviaremos as requisições.

4. Obtendo credenciais na APIBrasil

Primeiramente, faça login em
app.apibrasil.io.
No menu Minhas APIs, clique em API do WhatsApp e copie
seus tokens. Logo em seguida, armazene‑os em variáveis de ambiente
ou num arquivo .env; dessa forma, você evita vazamentos no repositório.

5. Analisando o código linha a linha

<?php
// notification.php

require_once __DIR__.'/vendor/autoload.php';

use ApiBrasil\Service;

// 5.1 – Envia texto pelo WhatsApp
$response = Service::WhatsApp('sendText', [
    'Bearer'      => getenv('BEARER_TOKEN'),
    'DeviceToken' => getenv('DEVICE_TOKEN'),
    'body' => [
        'number' => '5531994359434',
        'text'   => '🟢 Bem‑vindo ao APIBrasil!'
    ]
]);

// 5.2 – Tratamento básico de retorno
if ($response) {
    echo 'Notificação enviada com sucesso!';
    exit;
}

var_dump($response);

Observe que usamos getenv para carregar os tokens, assim o script
continua seguro. Além disso, qualquer falha é exibida com var_dump,
o que facilita o diagnóstico inicial.

6. Testando no terminal

Assim que o arquivo estiver salvo, execute:

php notification.php

Se tudo correr bem, a mensagem aparecerá no seu WhatsApp em poucos segundos.

7. Limites do plano gratuito

Atualmente, o plano free da API do WhatsApp permite
100 requisições diárias, renovadas automaticamente.
Desse jeito, você consegue validar POCs ou pequenos projetos sem custos.

8. Webhooks e socket.io

Por outro lado, caso precise receber mensagens ou eventos de status,
a plataforma disponibiliza webhooks gratuitos e integração via socket.io.
Dessa maneira, é possível criar chatbots bidirecionais sem depender
de “long polling”.

9. Boas práticas de produção

• Use filas (Redis ou RabbitMQ). Dessa forma, você evita picos de latência.
• Implemente retry exponencial para falhas HTTP 5xx. Assim, reduz perda de mensagens.
• Rotacione tokens a cada 90 dias. Consequentemente, vazamentos causam menos danos.
• Faça log estruturado em JSON. Além disso, envie métricas ao Prometheus ou Grafana.

10. Segurança e links úteis

Contudo, não armazene o Bearer Token em texto‑plano.
Portanto, utilize cofres de segredos, como HashiCorp Vault
ou AWS Secrets Manager. Dessa maneira, você garante compliance
e evita vazamentos. Para detalhes, consulte nosso
guia interno.

• The Twelve‑Factor App — boas práticas de configuração.
• Integração WhatsApp + rastreamento

11. Perguntas frequentes (FAQ)

11.1 – Posso enviar arquivos (PDF, imagem) pela API do WhatsApp?

Sim. Inclusive, o SDK suporta métodos como sendDocument e sendImage.

11.2 – Consigo agendar mensagens?

Atualmente não, porém, é possível usar sua própria fila
e agendar via cron ou Laravel Scheduler.

11.3 – A API suporta grupos?

Sim, desde que o número esteja no grupo e possua permissão de
administrador. Dessa forma, evita‑se spam.

Conclusão

Por fim, integrar a API do WhatsApp da APIBrasil é fácil, rápido
e econômico. Agora que você domina instalação, código, limites,
webhooks e segurança, basta colocar a aplicação em produção
e impressionar seus usuários com mensagens instantâneas.

Compartilhe nos comentários se deu certo para você; seu feedback
mantém este conteúdo atualizado e gratuito!