API WhatsApp

Envía mensajes de WhatsApp desde sistemas externos. Costo: $0.01 por mensaje enviado, descontado de tu billetera Guibis. Incluye soporte para texto, multimedia en Base64 y registro completo de historial.

1. Enviar Mensaje de Texto

POSThttps://v7.guibis.com/api/whatsapp/send-message

Headers

Authorization: Bearer {tu_id_e}
Content-Type: application/json

REQUEST PAYLOAD

{
  "numero_id": 12,
  "to": "0991234567",
  "message": "Hola! Tu pedido #1234 ha sido confirmado y está en camino."
}

RESPONSE EXPECTED

{
  "success": true,
  "status": 200,
  "data": { "status": "sent", "message": "Mensaje enviado correctamente." },
  "costo_debitado": 0.01,
  "nuevo_saldo": 9.99
}

2. Enviar Imagen / Documento (Base64)

POSThttps://v7.guibis.com/api/whatsapp/send-message

Headers

Authorization: Bearer {tu_id_e}
Content-Type: application/json

REQUEST PAYLOAD

{
  "numero_id": 12,
  "to": "0991234567",
  "message": "Aquí está tu factura adjunta.",
  "mediaBase64": [
    {
      "base64": "JVBERi0xLjQK...",
      "mimetype": "application/pdf",
      "filename": "factura_001.pdf"
    }
  ]
}

RESPONSE EXPECTED

{
  "success": true,
  "status": 200,
  "data": { "status": "sent", "message": "Mensaje con media enviado correctamente." },
  "costo_debitado": 0.01,
  "nuevo_saldo": 9.98
}

3. Webhook — Mensajes Entrantes (Recepción)

POST{tu_url_webhook}/whatsapp/api/chatbot/incoming

Headers

Content-Type: application/json
X-Internal-Key: {wsp_internal_key}

REQUEST PAYLOAD

// Payload que el servidor Node.js de Guibis envía a tu endpoint:
{
  "sessionId": "wsp_empresa_42_num_12",
  "from": "593991234567",
  "body": "Quiero información de sus productos",
  "type": "text",
  "timestamp": 1721000000,
  "isGroup": false,
  "contact": { "pushname": "Juan Pérez", "number": "593991234567" }
}

RESPONSE EXPECTED

// Tu servidor responde con el mensaje de salida (opcional):
{
  "success": true,
  "reply": "¡Hola Juan! Gracias por contactarnos. ¿En qué podemos ayudarte?",
  "processed": true
}

¿Listo para integrar?

Accede al panel de Guibis para obtener tu API Key y la documentación completa.

Documentación completa Ir al Panel