Maytapi
Maytapi/Documentação/Guia de PHP
Guia de PHPCerca de 10 minutosComo enviar uma mensagem no WhatsApp com PHP
Envie mensagens de texto e mídia pelo PHP com uma única requisição HTTP e receba as respostas no seu próprio webhook. REST e JSON puros — sem SDK, sem aprovação de templates.
Última atualização:
- PHP
- REST + JSON
- sem SDK
- respostas via webhook
<?php
$pid = "your-pid";
$phoneId = "your-phone-id";
$token = "your-token";
$ch = curl_init("https://api.maytapi.com/api/$pid/$phoneId/sendMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $token", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
"to_number" => "55119xxxxxx67",
"type" => "text",
"message" => "Hello from PHP!",
]),
]);
echo curl_exec($ch);O que você precisa
Quatro coisas, todas disponíveis no console em poucos minutos.
-
conta
Uma conta Maytapi
Cadastre-se e comece o teste grátis — sem cartão.
-
telefone
Um número pareado
Escaneie o QR code com o WhatsApp do seu celular. Seu número continua funcionando normalmente.
-
token
pid e token
Copie da página de token do console; o phone_id aparece ao lado do seu número.
-
PHP
Um ambiente PHP
Basta uma versão recente do PHP e seu cliente HTTP padrão.
Envie uma mensagem de texto com PHP
Faça um POST com corpo JSON para /sendMessage com o token no cabeçalho x-maytapi-key. A mensagem entra na fila do seu celular e a resposta volta na hora.
- ✓to_number em formato internacional, ex.: 55119xxxxxx67
- ✓type: text e o texto da mensagem
- ✓A resposta traz o id da mensagem
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"to_number": "55119xxxxxx67", "type": "text", "message": "Hello from PHP!"}'{
"success": true,
"data": {
"chatId": "55119xxxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Envie imagem, vídeo ou documento
Use o mesmo endpoint com type media e uma URL pública ou um data URI em base64. Adicione legenda e nome de arquivo opcionais.
- ✓Imagens, vídeo, áudio, PDF e outros documentos
- ✓Legenda no campo text
- ✓Data URIs em base64 funcionam como URLs
$ch = curl_init("https://api.maytapi.com/api/$pid/$phoneId/sendMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $token", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
"to_number" => "55119xxxxxx67",
"type" => "media",
"message" => "https://example.com/invoice-10482.pdf",
"text" => "Your invoice for order #10482",
"filename" => "invoice-10482.pdf",
]),
]);
echo curl_exec($ch);Receba respostas com um webhook em PHP
Registre a URL do webhook uma vez. Mensagens recebidas e confirmações de entrega e leitura chegam em JSON; responda pela URL reply de cada evento.
- ✓Retorne 200 rápido e depois processe o evento
- ✓Ignore suas próprias mensagens com fromMe
- ✓Use event.reply para responder no mesmo chat
$ch = curl_init("https://api.maytapi.com/api/$pid/setWebhook");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $token", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["webhook" => "https://example.com/maytapi/webhook"]),
]);
echo curl_exec($ch);<?php
// webhook.php
$event = json_decode(file_get_contents("php://input"), true);
http_response_code(200);
if (($event["type"] ?? "") === "message" && !$event["message"]["fromMe"]) {
$ch = curl_init($event["reply"]);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $token", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
"to_number" => $event["conversation"],
"type" => "text",
"message" => "Thanks! We received your message.",
]),
]);
curl_exec($ch);
}FAQ da WhatsApp API com PHP
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →Existe um SDK oficial para PHP?
Não é necessário. A API é REST com JSON, então o cliente HTTP padrão do PHP basta, como mostram os exemplos desta página.
Posso enviar mensagens para grupos com PHP?
Sim. Use o id do grupo (termina em @g.us) como to_number; os endpoints de grupos estão disponíveis em todos os planos.
Por que minha mensagem não chegou?
Verifique se o status do telefone está ativo e confira a fila e os logs no console. Números novos devem ser aquecidos antes de envios em volume.
Mais recursos da WhatsApp API
Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.