WhatsApp API
lista para integrar

# Enviar mensaje de texto
curl -X POST https://api.whapi.appsociety.cloud/api/messages/send \
  -H "X-API-Key: sk_live_a8d3f..." \
  -H "Content-Type: application/json" \
  -d '{
       "sessionId": "soporte-01",
       "to": "59170000000",
       "message": "Hola María, tu pedido está listo! 📦"
     }'

# Respuesta
{
  "success": true,
  "messageId": "3EB0C767D097B7C5825D",
  "status": "sent"
}

# Crear y lanzar campaña masiva
curl -X POST https://api.whapi.appsociety.cloud/api/campaigns \
  -H "X-API-Key: sk_live_a8d3f..." \
  -H "Content-Type: application/json" \
  -d '{
       "sessionId": "ventas-01",
       "name": "Promo Marzo",
       "message": "Hola {{name}}, tenemos 20% OFF 🎉",
       "audience": { "tags": ["cliente"] }
     }'

# Respuesta
{
  "success": true,
  "campaignId": "64a3f8b2c1",
  "status": "scheduled"
}

# Tu servidor recibe este JSON (POST)
# cuando llega un mensaje a tu número

{
  "event": "message.received",
  "sessionId": "soporte-01",
  "from": "59170000000",
  "body": "Hola, ¿tienen stock?",
  "type": "text",
  "timestamp": "2026-03-27T10:00:00Z"
}

# Enviar imagen, PDF, video o audio
curl -X POST https://api.whapi.appsociety.cloud/api/messages/media \
  -H "X-API-Key: sk_live_a8d3f..." \
  -H "Content-Type: application/json" \
  -d '{
       "sessionId": "soporte-01",
       "to": "59170000000",
       "caption": "Mira nuestro nuevo catálogo 📄",
       "mediaUrl": "https://tusitio.com/catalogo.pdf"
     }'

# Respuesta
{
  "success": true,
  "messageId": "5FB2A145E7A...",
  "status": "sent"
}

# Enviar una encuesta en el chat
curl -X POST https://api.whapi.appsociety.cloud/api/messages/poll \
  -H "X-API-Key: sk_live_a8d3f..." \
  -H "Content-Type: application/json" \
  -d '{
       "sessionId": "soporte-01",
       "to": "59170000000",
       "name": "¿Qué producto prefieres?",
       "options": ["Laptop", "Monitor", "Teclado"],
       "selectableOptionsCount": 1
     }'

# Respuesta
{
  "success": true,
  "messageId": "8AA9C211FBB...",
  "status": "sent"
}

# Crear nueva sesión y generar QR para vincular dispositivo
curl -X POST https://api.whapi.appsociety.cloud/api/sessions/create \
  -H "X-API-Key: sk_live_a8d3f..." \
  -H "Content-Type: application/json" \
  -d '{
       "sessionId": "nuevo-cliente-02"
     }'

# Respuesta
{
  "success": true,
  "qr": "1@xyz123abc...",
  "qrImageUrl": "https://api.whapi.appsociety.cloud/qr/nuevo-cliente-02.png",
  "message": "Escanea este QR con tu app de WhatsApp."
}