Conectar WhatsApp

Conectas tu número de WhatsApp y cada chat entrante se convierte en un ticket: tu equipo responde desde la bandeja de MelonHelp y el cliente recibe la respuesta en su WhatsApp.

Hay dos formas de conectar. La recomendada es la API oficial de WhatsApp (Cloud API).

Opción recomendada: WhatsApp oficial (Cloud API)

Es la vía oficial de Meta: sin riesgo de que bloqueen tu número y con soporte de plantillas. Puedes conectar el mismo número que ya usas en la app de WhatsApp Business y seguir usándolo en el teléfono (modo coexistencia).

Qué necesitas antes de empezar

• Tu empresa ya configurada en Meta: una cuenta de Facebook con historial, un portafolio comercial y una página de Facebook. Es lo primero que revisa Meta, y si falta, el asistente puede bloquear la conexión pidiendo verificación de identidad. Prepáralo en 10 minutos con la guía de requisitos de Meta.
• El número activo en la app de WhatsApp Business (no en el WhatsApp personal).
• El teléfono a mano para escanear un código durante la conexión.
• Un medio de pago en Meta: las plantillas tienen un costo por mensaje que se cobra a la cuenta de Meta del titular del número (ver Plantillas y costo).

Pasos

1. En Tickets, ve a Integraciones → WhatsApp → Conectar WhatsApp y elige WhatsApp oficial (Cloud API).
2. Se abre el asistente de Meta. Inicia sesión con Facebook y elige el portafolio de negocio de tu empresa.
3. Elige conectar tu app de WhatsApp Business (coexistencia) y escribe el número que ya usas.
4. Meta muestra un código: abre la app de WhatsApp Business en tu teléfono → Dispositivos vinculados → Conectar a la Plataforma de negocios y escanéalo.
5. Confirma y vuelve a MelonHelp. La línea aparece como Conectado (con el sello Oficial).
6. Escríbele al número desde otro teléfono para probar: debería aparecer un ticket nuevo.

Coexistencia o dedicado

Durante la conexión eliges el modo:

• Coexistencia (recomendado para empezar): sigues usando la app de WhatsApp Business en el teléfono y MelonHelp recibe y responde por API, a la vez. No cambias tu operación actual. Puede tener alguna desconexión ocasional.
• Dedicado (Cloud API puro): máxima estabilidad y todas las funciones, pero ese número deja de usarse en la app del teléfono. Ideal cuando ya operas 100% desde MelonHelp.

Cómo se trabaja

• Cada conversación de WhatsApp es un ticket con el número del cliente como contacto.
• Respondes desde el ticket; el mensaje sale por WhatsApp.
• Todo lo demás — estados, prioridades, SLA — aplica normal.
• ¿El mismo cliente te escribe también por email? Puedes unificarlo en un solo contacto desde el ticket (botón Editar cliente → Fusionar). Ver Contactos.

Plantillas y costo

WhatsApp permite responder texto libre y gratis mientras la conversación está abierta (dentro de las 24 horas desde el último mensaje del cliente). Para iniciar o reabrir una conversación fuera de esa ventana — por ejemplo, avisar que un ticket se resolvió al día siguiente — necesitas una plantilla aprobada.

• Crea plantillas desde Integraciones → WhatsApp, bajo tu línea conectada: eliges una del catálogo (ticket creado, resuelto, nueva respuesta, recordatorio) y se envía a revisión de Meta. La aprobación suele tardar hasta 24 horas.
• Costo: las plantillas tienen un precio por mensaje que fija Meta según categoría (las de aviso de ticket son utility, la categoría más barata) y país. MelonHelp no agrega ningún recargo, y el cargo va directo a la cuenta de Meta del titular del número — por eso durante la conexión se pide un medio de pago.
• Los mensajes de respuesta dentro de la ventana de 24 horas no tienen costo.

Opción alternativa: vincular con QR (piloto)

También puedes vincular un número por código QR, como WhatsApp Web. Es una conexión no oficial: úsala solo con números de prueba, porque Meta puede bloquear el número si detecta automatización. Para producción, usa la API oficial.

En el roadmap

El agente de IA respondiendo automáticamente en WhatsApp. Hoy WhatsApp crea tickets para tu equipo; la IA responde en el widget.

Problemas comunes

• El asistente de Meta pidió un video selfie o bloqueó la solicitud → A tu empresa le falta el portafolio comercial o la página de Facebook, o la cuenta que usaste es demasiado nueva. El número no está baneado: es el proceso de verificación del negocio. Prepara todo con la guía de requisitos de Meta — incluye cómo apelar si ya te bloquearon.
• La línea oficial quedó "Conectando" y no pasa a Conectado → El cliente aún no terminó el asistente de Meta, o Meta sigue revisando el número (WABA en revisión). Usa Verificar conexión en la misma pantalla; si persiste, revisa en Meta que el número no tenga avisos pendientes.
• El webhook figura "no verificado" → Se verifica solo cuando llega el primer mensaje al número: mándate un WhatsApp de prueba.
• Una plantilla quedó "Rechazada" → Suele ser por categoría mal elegida o contenido no permitido; ajústala y vuelve a enviarla a revisión.
• La conexión por QR (piloto) se cae → El teléfono perdió internet o cerró sesión: reconecta escaneando el QR de nuevo. Para estabilidad real, pasa a la API oficial.