Maytapi
Maytapi/Documentación/Guía de PHP
Guía de PHPUnos 10 minutosCómo enviar un mensaje de WhatsApp con PHP
Envía mensajes de texto y multimedia desde PHP con una sola petición HTTP y recibe las respuestas en tu propio webhook. REST y JSON puros: sin SDK ni aprobación de plantillas.
Última actualización:
- PHP
- REST + JSON
- sin SDK
- respuestas por 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" => "3461xxxxx67",
"type" => "text",
"message" => "Hello from PHP!",
]),
]);
echo curl_exec($ch);Qué necesitas
Cuatro cosas, todas disponibles en la consola en pocos minutos.
-
cuenta
Una cuenta de Maytapi
Regístrate e inicia la prueba gratuita, sin tarjeta.
-
teléfono
Un número vinculado
Escanea el código QR con WhatsApp en tu teléfono. Tu número sigue funcionando como siempre.
-
token
pid y token
Cópialos de la página de token de la consola; el phone_id aparece junto a tu número.
-
PHP
Un entorno de PHP
Basta con una versión reciente de PHP y su cliente HTTP estándar.
Envía un mensaje de texto con PHP
Haz un POST con un cuerpo JSON a /sendMessage con tu token en la cabecera x-maytapi-key. El mensaje se encola en tu teléfono y la respuesta llega al instante.
- ✓to_number en formato internacional, p. ej. 3461xxxxx67
- ✓type: text y el texto del mensaje
- ✓La respuesta incluye el id del mensaje
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": "3461xxxxx67", "type": "text", "message": "Hello from PHP!"}'{
"success": true,
"data": {
"chatId": "3461xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Envía una imagen, un video o un documento
Usa el mismo endpoint con type media y una URL pública o un data URI en base64. Añade un pie de foto y un nombre de archivo opcionales.
- ✓Imágenes, video, audio, PDF y otros documentos
- ✓Pie de foto en el campo text
- ✓Los data URI en base64 funcionan igual que las URL
$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" => "3461xxxxx67",
"type" => "media",
"message" => "https://example.com/invoice-10482.pdf",
"text" => "Your invoice for order #10482",
"filename" => "invoice-10482.pdf",
]),
]);
echo curl_exec($ch);Recibe respuestas con un webhook en PHP
Registra la URL del webhook una vez. Los mensajes entrantes y las confirmaciones de entrega y lectura llegan en JSON; responde con la URL reply incluida en cada evento.
- ✓Devuelve 200 rápido y luego procesa el evento
- ✓Omite tus propios mensajes con fromMe
- ✓Usa event.reply para responder en el mismo 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 de WhatsApp API con PHP
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Hay un SDK oficial para PHP?
No hace falta. La API es REST con JSON, así que basta con el cliente HTTP estándar de PHP, como muestran los ejemplos de esta página.
¿Puedo enviar mensajes a grupos desde PHP?
Sí. Usa el id del grupo (termina en @g.us) como to_number; los endpoints de grupos están disponibles en todos los planes.
¿Por qué no llegó mi mensaje?
Comprueba que el estado del teléfono esté activo y revisa la cola y los registros en la consola. Los números nuevos deben calentarse antes de enviar en volumen.
Más funciones de WhatsApp API
Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.