API de Envío del WCR

Amplía tu alcance más allá del Agent Workspace. Envía mensajes proactivos de WhatsApp desde tu propio CRM, Bot, IA, plataforma de e-commerce o scripts personalizados — manteniendo cada interacción perfectamente sincronizada dentro de Zendesk.

Ver Documentación de la API

Cómo Encaja la API

WCR expone dos superficies de API distintas, cada una dirigida a una audiencia y nivel de confianza diferentes. Una es para uso de terceros y la otra se conecta con la plataforma Zendesk — nunca directamente a la Cloud API de Meta.

┌──────────────────────────────────────────────────────────────┐
│                      SISTEMAS EXTERNOS                       │
│        CRM · ERP · n8n · Zapier · Make · Scripts propios     │
└──────────────────────────────┬───────────────────────────────┘
                               │ HTTPS  (autenticación por token)
              ┌────────────────▼──────────────────┐
              │    API de Envío de WhatsApp       │
              │  Envía y consulta mensajes WA     │
              └────────────────┬──────────────────┘
                               │
┌──────────────────────────────▼───────────────────────────────┐
│                        BACKEND WCR                           │
│  ┌──────────────────────────┐  ┌──────────────────────────┐  │
│  │  App API                 │  │  Capa Webhook Sunco      │  │
│  │  Sunco API               │  │  Eventos entrantes       │  │
│  └──────────────────────────┘  └──────────────────────────┘  │
│  ┌──────────────────────────────────────────────────────┐    │
│  │        Mensajes · Plantillas · Usuarios · Logs       │    │
│  └──────────────────────────────────────────────────────┘    │
└──────────────┬─────────────────────────────┬─────────────────┘
               │ Zendesk Support API         ▲ Zendesk Conversations
               │ tickets y notas privadas    │ API events
┌──────────────▼─────────────────────────────┴─────────────────┐
│                     PLATAFORMA ZENDESK                       │
│  ┌────────────────────┐   ┌──────────────────────────────┐   │
│  │  Zendesk Support   │   │  Conversations API (Sunco)   │   │
│  │  Tickets · Agentes │   │  Canal(es) de WhatsApp       │   │
│  └────────────────────┘   └───────────────┬──────────────┘   │
└─────────────────────────────────── ───────┼──────────────────┘
                                            │
                                ┌───────────▼──────────────┐
                                │     Meta Cloud API       │
                                │  (WCR nunca llama aquí)  │
                                └──────────────────────────┘

Capa de Integración con Zendesk

WCR utiliza internamente dos superficies de la API de Zendesk, independientemente de si un mensaje se origina desde la barra lateral del agente, una carga masiva o una llamada externa a la API de Envío de WhatsApp.

Zendesk Support API — saliente

Después de cada entrega de mensaje, WCR llama a la Zendesk Support API para registrar el evento como una nota privada en el ticket vinculado. Si no existe ningún ticket para el destinatario, se crea uno automáticamente. Tus agentes siempre tienen el contexto completo — incluso cuando el disparador provino de un CRM externo o una herramienta de automatización.

Zendesk Conversations API — entrante

WCR nunca se comunica directamente con la Meta Cloud API. En su lugar, cada conexión en el WCR está asociada a uno o más Canales de WhatsApp de Zendesk. Zendesk gestiona la relación con la Meta Cloud API en tu nombre — WCR registra su endpoint webhook de Sunco como suscriptor de la Conversations API y recibe los mensajes de WhatsApp entrantes y los eventos de entrega/error a medida que llegan.

Esta arquitectura significa que:

• No necesitas gestionar las credenciales de la API de Meta dentro del WCR
• Todo el cumplimiento de WhatsApp y la gestión de límites de tasa en la capa de Meta es responsabilidad de Zendesk
• Tus número(s) de WhatsApp permanecen bajo tu cuenta de Zendesk, no en un intermediario externo

Autenticación

Todas las solicitudes a la API de Envío de WhatsApp requieren un token pasado en el header Authorization. Los tokens tienen alcance a una conexión WCR específica — revocar una conexión invalida inmediatamente su token sin afectar a otras integraciones.

No se comparte ninguna clave de API entre conexiones. Si una integración se ve comprometida, solo hay que rotar el token de esa conexión.

Formato de Solicitud y Respuesta

Todas las solicitudes y respuestas son JSON. Cada respuesta sigue el mismo envelope predecible — tu integración solo necesita comprobar un campo:

{ "status": "ok", "data": { ... } }    // éxito
{ "status": "ko", "error": "..." }     // fallo

Enviar un mensaje:

{
  "subdomain": "tu-subdominio-zendesk",
  "template_name": "tu_plantilla_aprobada",
  "language": "es_ES",
  "messages": [
    {
      "phone": "+34666000000",
      "ri_body_param_1": "Juan",
      "ri_body_param_2": "PEDIDO-1234"
    }
  ],
  "ticket_id": 157,
  "origin": "mi_sistema_erp"
}

Consultar el estado de entrega:

GET ?phone=+34666000000&delivery_date_from=2024-01-01

→ { "status": "ok", "data": [ { "status": "processed_ok", ... } ] }

Estados de entrega posibles: pending · in_progress · processed_ok · processed_ko

Consulta la Documentación de la API para más información.

Seguridad y Cumplimiento

• Aplicación del opt-out: la lista negra global se comprueba antes de cada entrega — los números dados de baja se omiten automáticamente, sin necesidad de ninguna acción por parte del llamante
• Listo para el RGPD: cada llamada a la API respeta tu configuración de soberanía de datos y las reglas de lista negra
• Seguridad en el transporte: todo el tráfico es HTTPS — no se aceptan llamadas API sin cifrar

Acelera Tu Integración

Documentación Completa

Nuestro portal para desarrolladores contiene descripciones detalladas de los endpoints, referencias de parámetros, guías de autenticación y explicaciones de los códigos de estado.

Acceder a la Documentación para Desarrolladores →

Colección de Postman

Importa nuestra colección oficial de Postman para empezar a probar endpoints e inspeccionar payloads de muestra de inmediato — sin necesidad de configuración manual.

Descargar Colección de Postman

Soporte de Webhooks y Automatización

Conecta WCR a Make, n8n o Zapier para crear flujos de trabajo reactivos sin escribir código personalizado. Las respuestas entrantes de WhatsApp se reenvían a tu endpoint webhook configurado en tiempo real.