Maytapi
Maytapi/Documentación/Getting started
Getting startedUnos 10 minutosCómo enviar tu primer mensaje de WhatsApp con la API
De una cuenta nueva a un mensaje entregado en cuatro pasos: vincula tu número, copia tus credenciales, envía una petición y recibe la confirmación de entrega. Sin proceso de aprobación ni plantillas.
- vinculación por QR
- pid y token
- una petición POST
- entrega en el webhook
Cuatro pasos hasta tu primer mensaje
Todo lo siguiente se hace desde la consola y un terminal; no hace falta SDK.
-
step 1
Crea una cuenta
Regístrate en la consola e inicia la prueba gratuita, sin tarjeta.
-
step 2
Vincula tu número
Añade un teléfono y escanea el QR con WhatsApp en tu móvil (Dispositivos vinculados). Tu número se queda como está.
-
step 3
Copia tus credenciales
Tu pid y tu token están en la página de token de la consola; el phone_id aparece junto a tu número.
-
step 4
Envía la petición
Haz un POST a /sendMessage con la cabecera x-maytapi-key y un cuerpo JSON.
Encuentra pid, phone_id y token
Todas las peticiones usan la misma URL base con tu pid y phone_id, y tu token en la cabecera x-maytapi-key. También puedes listar tus teléfonos por API.
- ✓Token y pid: consola → Settings → Token
- ✓phone_id: junto a cada número o con /listPhones
- ✓Mantén el token en secreto: da acceso total a tu cuenta
curl "https://api.maytapi.com/api/$PID/listPhones" \ -H "x-maytapi-key: $TOKEN"
Envía el primer mensaje
Envía un mensaje de texto a cualquier número de WhatsApp en formato internacional. La petición añade el mensaje a la cola de tu teléfono y responde al instante.
- ✓to_number en formato internacional, p. ej. 3461xxxxx67
- ✓type: text con un message
- ✓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 the Maytapi WhatsApp API!"
}'const res = await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ to_number: "3461xxxxx67", type: "text", message: "Hello from the Maytapi WhatsApp API!" })
});
console.log(await res.json());import requests
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={"to_number": "3461xxxxx67", "type": "text", "message": "Hello from the Maytapi WhatsApp API!"},
timeout=10,
)
print(res.json())Comprueba que ha llegado
Configura un webhook para recibir las confirmaciones de entrega y lectura, o revisa el estado del teléfono si un mensaje no sale.
- ✓/setWebhook para confirmaciones y mensajes entrantes
- ✓/{phone_id}/status y /screen para la sesión
- ✓/{phone_id}/queue para ver mensajes pendientes
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/status" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/queue" \ -H "x-maytapi-key: $TOKEN"
curl -X POST "https://api.maytapi.com/api/$PID/setWebhook" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhook": "https://example.com/maytapi/webhook"
}'Qué hacer después
-
Recibe mensajes
Configura el webhook para recibir mensajes entrantes y confirmaciones.
-
Añade botones
Envía botones, listas y carruseles desde el mismo endpoint.
-
Evita bloqueos
Calienta los números nuevos y aprende qué provoca las restricciones.
Preguntas frecuentes para empezar
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Necesito un número nuevo?
No. Vinculas tu número de WhatsApp actual con un QR y sigue funcionando en tu teléfono como siempre.
¿Por qué no ha llegado mi mensaje?
Revisa primero el estado del teléfono: la sesión debe estar activa. Después mira la cola y los logs en la consola. WhatsApp también puede limitar los primeros mensajes a números nuevos; consulta la guía para evitar bloqueos.
¿Puedo probar sin pagar?
Sí. La prueba abre todos los endpoints durante tres días sin tarjeta.
Más funciones de la API de WhatsApp
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.