Skip to main content

​
Guía Rápida

Esta guía te llevará desde cero hasta enviar tu primer mensaje de WhatsApp en menos de 5 minutos.

​
Prerrequisitos

Una cuenta en Whaapy
Un número de WhatsApp Business conectado
Una API Key activa

​
Paso 1: Obtén tu API Key

  1. Inicia sesión en app.whaapy.com
  2. Ve a Configuración → API Keys
  3. Click en Generar Nueva Key
  4. 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

Autenticación

Aprende sobre API Keys y scopes

Enviar Mensajes

Referencia completa del endpoint