Configuración de WhatsApp

WhatsApp es el canal que los miembros realmente leen. Tasas de apertura superiores al 95 por ciento son típicas, y la mayoría de nuestra base de usuarios reporta mayor engagement en WhatsApp que en correo o SMS. GCM admite tres formas distintas de conectar una cuenta de WhatsApp, cada una con compromisos diferentes.

Esta página cubre cómo cablear las credenciales del proveedor. Para usar WhatsApp una vez conectado, consulta la guía de mensajería de WhatsApp.

Elige un proveedor

Tres opciones, perfiles de costo y complejidad muy diferentes:

Proveedor	Qué es realmente	Configuración	Costo	Mejor para
WACRM (basado en WAHA)	Tu cuenta real de WhatsApp, controlada vía la API web de WAHA	baja — escanear un QR	bajo	la mayoría de iglesias
WhatsApp Official	Business API de Meta directamente	alta	por mensaje tras nivel gratuito	alto volumen, solo plantillas
smsmobileapi WhatsApp	Un relay a través del WhatsApp de tu teléfono	baja	incluido con SMS	regiones donde los otros están limitados

TIP

Recomendamos WACRM para casi todos. Cámbiate a Official solo cuando realmente necesites mensajes de plantilla fuera de la ventana de servicio al cliente de 24 horas a escala.

Opción 1 — WACRM (basado en WAHA)

WACRM ejecuta WAHA (la WhatsApp HTTP API) sobre una sesión de teléfono. Escaneas un código QR desde un teléfono que tiene la cuenta de WhatsApp de tu iglesia, y desde entonces GCM puede enviar y recibir en esa cuenta a través de la plataforma WAHA.

Ve a Configuración → Canales → WhatsApp, elige WACRM (WAHA) como proveedor e ingresa:

• API key — emitida por WACRM (https://wa.locatecrm.com).
• API base — por defecto https://wa.locatecrm.com/v1; cámbiala solo si tu revendedor la aloja en otro lugar.
• Default session ID — la sesión de WACRM que posee el teléfono vinculado.
• Webhook secret — opcional, firma los webhooks entrantes de vuelta a GCM.

Vincula tu teléfono

En Configuración → Dispositivos WhatsApp, haz clic en Vincular un dispositivo. WACRM muestra un código QR; abre WhatsApp en el teléfono de la iglesia, ve a Dispositivos vinculados → Vincular un dispositivo y escanéalo. El estado cambia a working en diez segundos.

Una sesión vinculada permanece activa hasta que cierres sesión desde la lista de dispositivos vinculados del teléfono. Monitoreamos la salud de la sesión — si WACRM informa que la sesión cayó, el canal de WhatsApp se desactiva automáticamente y enviamos un correo a los admins de la organización.

Envío masivo

WACRM tiene su propio motor de ritmo que distribuye los envíos masivos a lo largo de horas para evitar las heurísticas anti-spam de Meta. Puedes enviar a 5,000 miembros con un clic; WACRM los pone en cola automáticamente y mostraremos el estado queued en los registros de mensajes hasta que cada uno se entregue.

Opción 2 — WhatsApp Official (Business API)

Esta es la API en la nube oficial de Meta. La configuración es significativamente más compleja — pero obtienes mayor rendimiento, mensajes de plantilla y la legitimidad de una insignia de empresa verificada.

Necesitarás:

1. Una cuenta de Meta Business Manager.
2. Una empresa verificada (pasaporte / documentos de la compañía).
3. Un número telefónico de WhatsApp Business que no esté registrado en un WhatsApp personal.
4. La Cloud API habilitada en tu app de Meta.

Luego en GCM:

• Access token — token de larga duración del Business System User de Meta.
• Phone number ID — el ID numérico que Meta asigna a tu número de empresa.
• Business account ID — el WABA ID.
• App secret — usado para verificar firmas de webhook entrante.
• Default template name / language — usado al enviar fuera de la ventana de servicio al cliente de 24 horas.

La ventana de 24 horas

Meta solo permite mensajes de formato libre dentro de las 24 horas posteriores al último mensaje del destinatario. Fuera de esa ventana, solo puedes enviar mensajes de plantilla preaprobados.

GCM detecta esto automáticamente: si un miembro no te ha enviado mensaje en 24 horas, recurrimos a la plantilla que configuraste en default_template_name. Si no hay plantilla configurada, el envío se rechaza con outside_24h_window. Verás esto en el registro de mensajes — no es un error, es la regla de Meta.

Webhook entrante

Tras guardar las credenciales, copia la URL del webhook que GCM te muestra (/channel-webhook?provider=whatsapp_official) y pégala en la configuración de Webhooks de tu app de Meta. Usa el token de verificación que GCM muestra. Una vez que Meta confirme, los mensajes entrantes, actualizaciones de estado y recibos de entrega fluyen todos hacia GCM.

Opción 3 — smsmobileapi WhatsApp

Un servicio de relay que usa el propio WhatsApp de tu teléfono. La misma configuración que su servicio de SMS: una clave de API impulsa tanto envíos SMS como WhatsApp, facturados juntos.

• API key — desde tu panel de smsmobileapi.

Compromiso: esto está limitado por la tasa del teléfono donde instalaste su aplicación. Bien para envíos de menos de 1,000 mensajes, doloroso en altos volúmenes.

Funciones por canal

Una vez configurado un proveedor, Configuración → Canales → WhatsApp te permite ajustar:

• Soporte de medios — desactiva si tu proveedor no admite imágenes / PDFs salientes.
• Máx. destinatarios por difusión masiva — predeterminado 500, puede bajar si quieres forzar lotes.
• Tokens de combinación — habilita personalización estilo {{first_name}} en plantillas.
• Enrutamiento de conversación bidireccional — los mensajes entrantes crean conversaciones para que el personal responda.

Probar la conexión

En Configuración → Canales → WhatsApp, pulsa Enviar mensaje de prueba. Enviamos un mensaje "Hola desde GCM" al teléfono principal del admin de la organización. Si llega en menos de 30 segundos, estás listo. Si no, revisa:

1. El registro de actividad del propio proveedor (panel de WACRM, herramienta de prueba de API de Meta, historial de smsmobileapi).
2. El teléfono sigue encendido, en línea, y la sesión está en working.
3. El destinatario no ha bloqueado el número del remitente.

Cuando las credenciales se rompen

El modo de fallo más común: alguien reinicia el teléfono de la iglesia y olvida reconectar. La sesión WAHA cae, los envíos comienzan a fallar. Enviaremos un correo a los admins tras 5 fallos consecutivos — re-vincula el teléfono en Configuración → Dispositivos WhatsApp para recuperar.

Referencias cruzadas

• Mensajería WhatsApp — cómo enviar realmente una vez configurado.
• Conversaciones — gestionar respuestas entrantes.
• Configuración de SMS — el respaldo de texto de menor costo.