WhatsApp

WhatsApp es el canal que tus miembros realmente leen. Las tasas de apertura por encima del 95 por ciento son típicas. GCM soporta WhatsApp a través de varios proveedores, incluyendo canales respaldados por WAHA (WACRM) y la API oficial de WhatsApp Business.

Configura un proveedor

Antes de poder enviar, configura un canal de WhatsApp en Configuración → Canales:

Proveedor	Ideal para	Dificultad de configuración
WACRM (respaldado por WAHA)	la mayoría de iglesias; usa una cuenta personal/empresarial de WhatsApp	baja
WhatsApp Oficial	mensajes de alto volumen, solo plantillas	alta (requiere verificación empresarial de Meta)
smsmobileapi WhatsApp	regiones donde los demás no están disponibles	media

Para WAHA: escanea un código QR desde un teléfono que tenga la cuenta de WhatsApp de tu iglesia. La conexión permanece activa hasta que cierres sesión desde la lista de dispositivos vinculados en ese teléfono.

Para Oficial: configura tu Meta Business Manager, registra un número de teléfono y proporciona el token de acceso en GCM. Te guiaremos en esto — escríbenos si necesitas el camino oficial de la API.

Envía un mensaje individual

Desde el perfil de un miembro:

1. Haz clic en la acción de mensaje.
2. Elige WhatsApp como canal.
3. Escribe el mensaje. Los tokens de fusión (p. ej. {{member.first_names}}) funcionan aquí.
4. Haz clic en enviar.

El mensaje llega al proveedor en segundos. El estado de entrega cambia de En cola → Enviado → Entregado → Leído durante los siguientes minutos (asumiendo que el destinatario tiene WhatsApp abierto).

Envía un mensaje masivo

Desde Mensajería → Enviar:

1. Elige destinatarios — una lista guardada, un filtro o pega números de teléfono.
2. Elige WhatsApp como canal.
3. Compón el mensaje.
4. Haz clic en enviar.

Para envíos de más de unos cientos de destinatarios, el endpoint masivo auto-ritma a través de días UTC. Esto evita el error de límite de tasa 429 burst_gate de los proveedores upstream y mantiene tu cuenta en buen estado.

La respuesta incluye:

• estimated_completion — cuándo se enviará el último mensaje.
• spans_days — cuántos días calendario abarcará el envío.

WARNING

Un envío masivo de WhatsApp a 10,000 destinatarios podría abarcar 3 días calendario. Si necesitas un envío de "disparar y olvidar" en el mismo día, divide tu audiencia y envía primero a la mitad urgente.

Mensajes de plantilla

La API oficial de WhatsApp Business solo permite texto arbitrario en una ventana de 24 horas después de que el destinatario te envió un mensaje por última vez. Fuera de esa ventana, debes usar un mensaje de plantilla preaprobado por Meta.

GCM soporta plantillas:

1. Registra el texto de la plantilla con Meta (en tu Business Manager).
2. En Mensajería → Plantillas, agrega el ID de la plantilla y las variables.
3. Al componer, elige la plantilla — las variables se rellenan con tokens de fusión.

Para canales respaldados por WAHA, esta restricción no aplica — puedes enviar texto libre en cualquier momento.

Lectura del estado de entrega

Cada envío aparece en Mensajería → Registro (la tabla communication_log). Para cada mensaje:

• Estado — En cola / Enviado / Entregado / Leído / Fallido.
• Código de respuesta del proveedor — específico del gateway, útil al depurar.
• Enviado el — marca de tiempo.
• Costo (si tu proveedor lo expone) — costo por mensaje.

Para envíos masivos, el registro agrupa por lote de envío con conteos agregados.

Respuestas

Cuando un miembro responde, el entrante aterriza en Conversaciones. El hilo de conversación mantiene ambas direcciones en una sola línea de tiempo.

TIP

Si WhatsApp muestra a un miembro como aún "escribiendo" horas después de que enviaste, el proveedor a menudo no ha recibido la confirmación de lectura todavía. La configuración de privacidad de WhatsApp permite al destinatario ocultar las confirmaciones de lectura — aún verías Entregado pero nunca Leído.

Números de teléfono

WhatsApp usa el mismo número de teléfono que la tarjeta SIM. Normalizamos los números a E.164 (+876...) antes de enviar. Si el perfil de un miembro tiene el número en formato local (876-555-1234), el módulo de mensajería avisará pero intentará interpretarlo.

Establece el código de país predeterminado de tu iglesia en Configuración → Organización para que los números en formato local se conviertan correctamente.

Costos

Los costos dependen del proveedor:

• WACRM — suscripción fija, sin cargo por mensaje.
• WhatsApp Oficial — cargos por conversación de Meta. Barato para las primeras 1,000 / mes, luego ~$0.005 por mensaje.
• smsmobileapi — por mensaje; revisa sus tarifas actuales.

Observa tu uso desde la página de canales si estás con un proveedor por mensaje.

Preguntas comunes

¿Puedo enviar medios (imágenes, PDFs)? Sí, tanto para WACRM como para Oficial. El archivo adjunto va en una fila separada del formulario de composición.

¿Por qué mi mensaje está atascado en "En cola"? El proveedor podría estar caído o limitando la tasa. Revisa Configuración → Canales para el estado de la conexión — un punto rojo significa que el proveedor no es alcanzable. Para WACRM, vuelve a escanear el QR si el teléfono se desconectó.

¿Los destinatarios ven el nombre de mi iglesia o mi número de teléfono? Ven cualquier cuenta de WhatsApp que vinculaste. La mayoría de iglesias usan un número dedicado etiquetado con el nombre de la iglesia, para que los destinatarios vean a la iglesia y no a una persona.

Próximos pasos

• Conversaciones — flujo de respuestas.
• Canales y desuscripción — administra proveedores y límites de tasa.
• Flujos de trabajo — automatiza seguimientos de WhatsApp.