Guía Rápida
Esta guía te llevará desde cero hasta enviar tu primer mensaje de WhatsApp en menos de 5 minutos.
Prerrequisitos
Un número de WhatsApp Business conectado
Paso 1: Obtén tu API Key
- Inicia sesión en app.whaapy.com
- Ve a Configuración → API Keys
- Click en Generar Nueva Key
- Copia tu API Key (formato:
wha_xxxxx...)
Tu API Key es secreta. No la compartas ni la expongas en código del lado del cliente.
Paso 2: Envía un Mensaje de Texto
El endpoint más simple para enviar un mensaje:
curl -X POST https://api.whaapy.com/messages/v1 \
-H "Authorization: Bearer wha_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+5215512345678",
"content": "¡Hola! Este es mi primer mensaje con Whaapy 🎉"
}'
Paso 3: Verifica la Respuesta
Una respuesta exitosa se ve así:
{
"messaging_product": "whatsapp",
"contacts": [{ "wa_id": "5215512345678" }],
"messages": [{ "id": "wamid.HBgLNTIxNTUxMjM0NTY3OA==" }],
"data": {
"message_id": "uuid-del-mensaje",
"conversation_id": "uuid-de-conversacion",
"status": "sent"
}
}
Paso 4: Envía Otros Tipos de Mensajes
Imagen
{
"to": "+5215512345678",
"type": "image",
"image": {
"link": "https://ejemplo.com/imagen.jpg",
"caption": "¡Mira esta imagen!"
}
}
Template (para mensajes fuera de ventana de 24h)
{
"to": "+5215512345678",
"type": "template",
"template": {
"name": "hello_world",
"language": {
"code": "es"
}
}
}
Documento
{
"to": "+5215512345678",
"type": "document",
"document": {
"link": "https://ejemplo.com/archivo.pdf",
"filename": "factura.pdf"
}
}
Manejo de Errores
Si algo sale mal, recibirás una respuesta con detalles del error:
{
"error": "message_delivery_failed",
"message": "La ventana de conversación de 24 horas ha expirado",
"code": "131047",
"action_required": "Usar template message",
"instructions": "Para contactar usuarios después de 24h, envía un template aprobado"
}
Si recibes error 131047 (ventana cerrada), necesitas enviar un template message primero. Los templates están pre-aprobados por Meta y pueden enviarse en cualquier momento.
Próximos Pasos
