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

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 🎉"
  }'

const response = await fetch('https://api.whaapy.com/messages/v1', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wha_TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5215512345678',
    content: '¡Hola! Este es mi primer mensaje con Whaapy 🎉'
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.whaapy.com/messages/v1',
    headers={
        'Authorization': 'Bearer wha_TU_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'to': '+5215512345678',
        'content': '¡Hola! Este es mi primer mensaje con Whaapy 🎉'
    }
)

print(response.json())

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.

Empezar

Conceptos

Guías del Agente

Automatizaciones

Integraciones

Guía rápida

Guía rápida

Prerrequisitos

Paso 1: Obtén tu API Key

Paso 2: Envía un Mensaje de Texto

Paso 3: Verifica la Respuesta

Paso 4: Envía Otros Tipos de Mensajes

Imagen

Template (para mensajes fuera de ventana de 24h)

Documento

Manejo de Errores

Próximos Pasos

Autenticación

Enviar Mensajes

​Guía rápida

​Prerrequisitos

​Paso 1: Obtén tu API Key

​Paso 2: Envía un Mensaje de Texto

​Paso 3: Verifica la Respuesta

​Paso 4: Envía Otros Tipos de Mensajes

​Imagen

​Template (para mensajes fuera de ventana de 24h)

​Documento

​Manejo de Errores

​Próximos Pasos

Autenticación

Enviar Mensajes

Guía rápida

Prerrequisitos

Paso 1: Obtén tu API Key

Paso 2: Envía un Mensaje de Texto

Paso 3: Verifica la Respuesta

Paso 4: Envía Otros Tipos de Mensajes

Imagen

Template (para mensajes fuera de ventana de 24h)

Documento

Manejo de Errores

Próximos Pasos