Sincroniza grupos de WhatsApp en tu CRM

Resumen

Los grupos de WhatsApp son la materia oscura de WhatsApp Business. Muchos CRMs los ignoran o meten todos los mensajes en un montón genérico de "contacto desconocido". Wazzap modela cada grupo como conversación de primera clase, indexada por el ID del grupo, con el avatar y el nombre del grupo tomados directo de WhatsApp.

Cada mensaje entrante y saliente que envía tu número dentro de cualquier grupo al que pertenezca aparece en la pestaña de Conversaciones del CRM. Los agentes ven quién dijo qué (con el número del participante), pueden responder al grupo completo, mencionar contactos y disparar workflows igual que en un chat 1 a 1.

Cómo funciona

1. Tu número conectado a Wazzap se une a (o ya pertenece a) un grupo de WhatsApp.
2. Wazzap detecta el grupo automáticamente y lo muestra en tu CRM como conversación nueva.
3. Los mensajes entrantes del grupo se transmiten en la conversación conforme llegan.
4. Para enviar al grupo, responde desde el mismo compositor y Wazzap se encarga del ruteo.

Recibir mensajes de grupo

Sin setup. Una vez que tu número está en el grupo, los mensajes empiezan a llegar al CRM. Cada mensaje carga metadata que puedes usar:

• Teléfono del remitente. El número real de WhatsApp del que escribió.
• Nombre del remitente. El display name que usa en WhatsApp.
• ID del grupo. Se usa para direccionar respuestas. Se ve como 120363025xxxxxxxx@g.us.
• Nombre y avatar del grupo. Tomados directo de WhatsApp.

Enviar a grupos

Para enviar un mensaje al grupo desde tu CRM, apunta al ID del grupo en vez de a un número individual:

to: 120363025XXXXXXXX@g.us
body: Equipo, el recap semanal ya está listo 👇

Con la integración HighLevel, responder desde la pestaña de conversación se encarga del direccionamiento por ti. Con la REST API, pasas la dirección @g.us como destinatario en tu POST /messages de siempre.

Cómo encontrar el ID del grupo

La forma más fácil: abre el grupo en tu CRM y mira el encabezado de la conversación. Wazzap muestra el ID ahí.

Para descubrimiento programático:

curl https://api.wazzap.mx/v4/groups \
  -H "Authorization: Bearer $WAZZAP_KEY"

Te devuelve una lista de cada grupo en el que está tu número, con su ID, nombre y conteo de participantes.

Límites del beta

• Confirmaciones de lectura por participante individual no sincronizan. WhatsApp no las expone por usuario en grupos.
• Eventos solo-admin (miembro agregado, removido, grupo renombrado) sincronizan como mensajes del sistema, no como triggers.
• Encuestas entrantes llegan como descripción en texto, no como widget interactivo.
• Menciones con @ entrantes sincronizan como texto plano, pero las menciones salientes funcionan nativas.
• El grupo debe tener tu número como miembro. Wazzap no puede leer grupos en los que no estás.

Solución de problemas

Los mensajes del grupo no aparecen en mi CRM

Confirma que tu número de Wazzap es miembro real del grupo (abre WhatsApp en el celular y verifica). Si lo es, refresca con fuerza el CRM y busca en la pestaña de Conversaciones. El primer mensaje que llega después de que el número se une es lo que dispara la creación de la conversación.

Mi respuesta saliente va al lugar equivocado

Doble-verifica que el ID del destinatario termine en @g.us. Un número normal termina en @s.whatsapp.net internamente. Son espacios de direcciones distintos, y un typo manda en silencio al chat 1 a 1 en lugar del grupo.

Me limitan dentro de un grupo activo

Marca el paso de los envíos salientes. WhatsApp limita a los bots que inundan grupos aún más agresivamente que el spam 1 a 1. Agrega un delay de 3 a 5 segundos entre envíos consecutivos, o usa el comando delay message para drips programados.