Skip to main content
WhatsApp es un canal del espacio de trabajo en Configuración → Canales → WhatsApp. Onboarding recomendado (solo en el dominio de la plataforma, p. ej. app.famulor.io): Registro integrado de WhatsApp (Conectar con Meta). En dominios personalizados de whitelabel, los espacios de trabajo usan únicamente el pegado manual de credenciales. Los números de Marketplace (Configuración → Números) son PSTN/SIP para voz telefónica. Ese mismo E.164 se convierte en número de WhatsApp solo después de que Meta lo verifique (OTP). La configuración de tu troncal SIP es independiente de la API de WhatsApp Cloud. Los helpers de SMS de la plataforma son solo SMS/MMS, no se usan para WhatsApp.

​
Requisitos previos

Usuarios del espacio de trabajo
  • El plan incluye WhatsApp de texto y/o WhatsApp de voz
  • Los webhooks usan tu URL base de la app (host de la plataforma o dominio personalizado verificado). Después de conectar, Configuración muestra la URL exacta del webhook para pegarla en Meta si hace falta, sin necesidad de acceso al entorno del servidor
Operadores de la plataforma (Registro integrado / app de Meta): consulta Registro integrado de WhatsApp.

​
Interfaz del producto

  1. Conectar con Meta (Registro integrado) — elige el asistente, número de Marketplace opcional, helper de OTP para SMS de Marketplace
  2. O pega las credenciales manualmente (token, secreto de la app, token de verificación, ID de número de teléfono, ID de WABA)
  3. Interruptores: texto / voz entrante / voz saliente
  4. Editar una conexión → Detalles del remitente de WhatsApp (nombre visible, respuestas automáticas con IA, mantener como no leído, perfil de negocio, Sincronizar perfil con WhatsApp, estado de las llamadas)
  5. Plantillas: borrador → Enviar a Meta → estado vía webhook + cron → enviar prueba
  6. Probar llamada de WhatsApp (POST /api/calls/whatsapp-outbound)
Webhook (tras conectar): https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId} Suscríbete a: messages, calls, message_template_status_update (API v23/v24). Para voz, activa también las llamadas en el número de teléfono (Editar → Activar llamadas en Meta).

​
Historial

  • Conversaciones de texto: canal WhatsApp (tablas messaging_*)
  • Voz: canal WhatsApp voice (calls.metadata.channel = whatsapp_voice)

​
Facturación

  • Texto: los créditos de mensajería de recepción/envío ya existentes
  • Voz: la reserva/liquidación de créditos por minuto de voz ya existente (igual que en las llamadas de teléfono/SIP)
  • Precios de conversación de Meta: método de pago del cliente en WhatsApp Manager (Tech Provider)

​
API pública

  • Registro integrado: GET/POST /api/whatsapp/embedded-signup, rutas de sesión OTP
  • Conectores de mensajería: GET/POST /api/v1/messaging-connectors con platform=whatsapp
  • Plantillas: GET/POST /api/v1/whatsapp/templates
  • Voz saliente: POST /api/v1/calls/whatsapp-outbound
  • MCP: herramientas de plantillas de WhatsApp + complete_whatsapp_embedded_signup + start_whatsapp_outbound_call
Consulta también Configuración del Registro integrado, Canales de mensajería, WhatsApp Voice.