WhatsApp con Bird: mensajes y campañas del club

La integración de WhatsApp a través de Bird permite al club de fidelización de Connect Manager mandar por WhatsApp la tarjeta del móvil, el enlace de acceso al área del socio y campañas, y enviar campañas por SMS, con la cuenta de Bird de Connect Manager o con la del propio club. No es una conexión con Ágora en sí, pero los socios a los que llega son los mismos que se identifican en el TPV Ágora. Este manual es para el técnico que la configura: qué pedir, dónde ponerlo, cómo funciona y qué hacer cuando un mensaje no llega.

Qué hace la integración#

• Envía la tarjeta del móvil por WhatsApp con la plantilla «wallet», que lleva los enlaces para añadirla a Apple Wallet y a Google Wallet: al dar de alta al socio desde el panel, si el envío automático está encendido, o a mano desde su ficha con «Enviar wallet».
• Deja entrar al área del socio con el teléfono: si el socio escribe su teléfono en el acceso del portal en vez del correo, recibe el enlace de acceso por WhatsApp con la plantilla «login». El enlace vale 15 minutos y una sola vez.
• Envía campañas por WhatsApp a los socios que han dado permiso para ese canal, con la plantilla «notificación»: el texto de la campaña entero va en su único parámetro.
• Envía campañas por SMS, en texto libre, por el canal de SMS de Bird.
• Elige la cuenta por canal: «Servicio propio», que es la cuenta de Bird de Connect Manager y su número, o «Bird (cuenta del portal)», la del propio club con su número y sus plantillas.
• Permite probar una campaña de WhatsApp mandándola a un teléfono por el mismo camino que el envío real, con valores de ejemplo.
• Respeta el consentimiento por canal (correo, SMS y WhatsApp, con fecha e histórico): las campañas de WhatsApp solo salen hacia quien tiene «Sí» en WhatsApp, y se vuelve a comprobar justo antes de enviar.
• Adjunta un cupón a la campaña y sustituye las variables {customer_name}, {balance}, {code} y las del cupón ({coupon_name}, {coupon_benefit}, {coupon_code}, {coupon_url}).
• Deja rastro: el estado de cada destinatario en los resultados de la campaña y, en la ficha del socio, la pestaña «Comunicaciones» con los envíos de acceso y de tarjeta.
• Controla el ritmo: las campañas de SMS y WhatsApp salen a 8 mensajes por segundo para que Bird no las corte.

Qué no hace#

• Mensajes libres por WhatsApp: solo plantillas aprobadas por Meta en Bird.
• Saber si el mensaje se entregó o se leyó: solo consta que Bird lo aceptó.
• Comprobar el consentimiento de SMS: las campañas por SMS van a todos los socios del segmento con teléfono.
• Reintentar los mensajes de campaña: cada uno se intenta una vez, para no mandarlo dos veces. Los de acceso y de tarjeta sí se reintentan.
• Conservar los saltos de línea en WhatsApp: Meta no los admite en un parámetro de plantilla, así que los párrafos se juntan con « · ».
• Comunicaciones automáticas por SMS: el SMS solo se usa en campañas.
• Recibir respuestas de los socios: no hay bandeja de entrada.
• El botón «Invitar por WhatsApp» de la tarjeta del móvil no pasa por Bird: abre el WhatsApp del propio socio con el mensaje escrito.

[!WARNING] El desplegable de proveedor de WhatsApp ofrece también «WhatsApp Web (gateway no oficial · Evolution/WAHA)». No forma parte de esta integración: enlaza un número por QR sin la API oficial, va contra las condiciones de Meta y puede acabar con el número bloqueado. Usa siempre Bird.

Requisitos#

• Una cuenta de Bird con un canal de WhatsApp Business (número verificado) y las plantillas aprobadas por Meta. Con «Servicio propio» son las de Connect Manager y las mantiene FOS; con la cuenta del club, el cliente da de alta su número y sus plantillas en su Bird.
• Un canal de SMS en Bird, si se van a enviar campañas por SMS.
• La cola de trabajos funcionando: todos los envíos van encolados.
• El club creado en Configuración → Portal público de clientes.
• Socios con teléfono. Sin prefijo se entienden como españoles (+34); los de otros países tienen que llevar su prefijo.
• Consentimiento de WhatsApp de los socios a los que se quiera mandar campañas.
• Permisos en el panel: «Fidelización: Activar por grupo» para la configuración del club y «Fidelización: Marketing» para las campañas.

Quién hace qué. FOS mantiene la cuenta de Bird de Connect Manager y sus plantillas. El cliente, si quiere su propio número, contrata Bird, conecta su número de WhatsApp y aprueba las plantillas. El técnico pega las credenciales, enciende las comunicaciones y hace las pruebas.

Datos que necesitamos#

Solo hacen falta si se usa la cuenta de Bird del club; con «Servicio propio» no se pide nada. Los campos que se dejen vacíos se toman de la cuenta de Connect Manager.

Parámetros que tienen que tener las plantillas, con estos nombres exactos y en español:

Configuración paso a paso#

1. En Bird (solo con la cuenta del club)#

1. Conecta el número de WhatsApp Business del club y anota el Channel ID del canal y el Workspace ID.
2. Crea las plantillas «login», «wallet» y «notificación» en español con los parámetros de la tabla. En las URL, la plantilla tiene que poner https:// delante del parámetro: Connect Manager manda las direcciones sin https://.
3. Espera a que Meta las apruebe y anota el Project ID y la versión de cada una.
4. Crea una Access Key con permiso para enviar mensajes.
5. Si va a haber campañas por SMS, da de alta el canal de SMS.

2. En Connect Manager: el proveedor de cada canal#

Ve a Configuración → Portal público de clientes, abre el club y entra en la subpágina Fidelización, sección «Servicios de comunicación (proveedores)»:

1. En «WhatsApp» elige Servicio propio (Bird de la plataforma) o Bird (cuenta del portal). Con la cuenta del club aparecen «WhatsApp · Workspace ID», «WhatsApp · Access Key», «WhatsApp · Channel ID», «WhatsApp · Plantilla login · Project ID», «WhatsApp · Plantilla login · Versión», «WhatsApp · Plantilla wallet · Project ID», «WhatsApp · Plantilla wallet · Versión», «WhatsApp · Plantilla notificación · Project ID» y «WhatsApp · Plantilla notificación · Versión».
2. En «SMS» elige Servicio propio (Bird de la plataforma) o Bird (cuenta del portal); con la del club, «SMS · Workspace ID», «SMS · Access Key» y «SMS · Channel ID».
3. Guarda.

En la misma sección se elige el proveedor del correo, que también puede ser Bird; ver Proveedores de envío de correo.

3. En Connect Manager: el acceso con teléfono y el envío de la tarjeta#

1. En la subpágina Comunicaciones del club, elige el «Canal» WhatsApp.
2. En «Acceso por WhatsApp (login con teléfono)», deja «Comunicación activada».
3. En «Envío del wallet para descarga», revisa «Comunicación activada», «Enviar automáticamente al registrarse» y «Enviar también por WhatsApp» (los tres vienen encendidos de serie). El envío automático es para las altas hechas en Administración → Clientes; con la bienvenida activada, en esas altas solo sale el WhatsApp, porque el correo de bienvenida ya lleva el botón de la tarjeta.
4. En la subpágina Apariencia, enciende «Permitir acceso con el teléfono (WhatsApp)». Debajo, «Estado del canal de WhatsApp» tiene que decir «Configurado.»: entonces el acceso pide «correo o teléfono». Con «Sin configurar.», sigue pidiendo solo el correo.

4. En Connect Manager: el consentimiento de WhatsApp#

• En la ficha del socio (Administración → Clientes), el bloque «Consentimiento comercial» tiene un desplegable por canal (Email, SMS y WhatsApp) con «Sí», «No» o «Sin contestar», y la fecha del último cambio.
• En la tienda online propia, el socio lo da al pagar (una casilla para los tres canales) o desde «Mi cuenta», canal a canal.
• En el portal de registro solo se recoge el permiso comercial general, que corresponde al correo: no da permiso de WhatsApp.

5. Crear una campaña por WhatsApp o SMS#

1. Ve a Administración → Campañas y crea una campaña.
2. Elige el «Canal» WhatsApp o SMS y el «Segmento (audiencia)». La estimación dice cuántos destinatarios hay «con teléfono y permiso de WhatsApp» o «con teléfono». Si el club no tiene WhatsApp listo, avisa ahí mismo.
3. Escribe el texto (un SMS admite unos 160 caracteres), adjunta un cupón si hace falta y, si quieres, «Programar para» una fecha.
4. Desde el listado, en la fila de la campaña, usa «Enviar prueba» (te pide un teléfono) y después «Enviar ahora». El botón «Plantillas» del listado guarda textos de campaña para reutilizarlos; no son las plantillas de WhatsApp.

Cómo funciona#

Campaña por WhatsApp#

Al lanzar la campaña se comprueba que el club tiene la plantilla de notificación lista y que el cupón adjunto, si lo hay, sigue vigente; si no, no se lanza. Se reserva el envío para que no salga dos veces aunque coincidan la programación y un clic, se cuentan los destinatarios y se encola un trabajo por socio, escalonado a 8 por segundo. Cada trabajo vuelve a mirar el permiso de WhatsApp, normaliza el teléfono a formato internacional, junta los párrafos en una línea y llama a la API de mensajes de Bird con la plantilla y el texto. Bird lo entrega a Meta, que lo hace llegar al móvil. El destinatario queda como enviado, fallido o suprimido, con el motivo en «Detalle».

sequenceDiagram
    participant P as Panel
    participant CM as Connect Manager
    participant B as Bird
    participant S as Móvil del socio
    P->>CM: Enviar ahora
    CM->>CM: Comprueba plantilla y cupón y encola un envío por socio
    CM->>CM: Revisa el permiso de WhatsApp y el teléfono
    CM->>B: POST mensaje con plantilla de notificación
    B->>S: WhatsApp con el texto de la campaña
    B-->>CM: Aceptado
    CM->>CM: Destinatario marcado como enviado

Lo que se manda a Bird es el destinatario (el teléfono en formato internacional) y la plantilla (su Project ID, su versión, el idioma es y los parámetros, cada uno con su nombre y su valor), a https://api.bird.com/workspaces/{workspace}/channels/{canal}/messages con la Access Key en la cabecera de autorización. Si Bird no contesta en 8 segundos o responde con error, ese destinatario queda como fallido.

Acceso con el teléfono#

El socio escribe su teléfono en el acceso del portal. Connect Manager comprueba que el club ofrece el acceso por WhatsApp, normaliza el número y busca al socio activo del club con ese teléfono; si hay dos fichas con el mismo número, no entra en ninguna. Genera un enlace de un solo uso válido 15 minutos y encola el envío con la plantilla «login». Por seguridad, la pantalla contesta lo mismo exista o no el teléfono, y cada teléfono puede pedir 3 enlaces cada 15 minutos.

sequenceDiagram
    participant S as Socio
    participant CM as Connect Manager
    participant B as Bird
    S->>CM: Escribe su teléfono en el acceso
    CM->>CM: Busca al socio y genera el enlace de 15 minutos
    CM->>B: Plantilla login con el enlace y el nombre del club
    B->>S: WhatsApp con el enlace de acceso
    S->>CM: Abre el enlace
    CM-->>S: Entra en su área privada

Envío de la tarjeta#

Al dar de alta un socio desde el panel, si el envío automático está activado, o al pulsar «Enviar wallet» en su ficha, se manda la plantilla «wallet» con los enlaces firmados para Apple y Google, válidos 14 días. Si una de las dos plataformas no está configurada, en su lugar va el enlace de la página que elige la tarjeta según el móvil.

Reintentos#

• Acceso y tarjeta: hasta 3 intentos, cada 30 segundos.
• Campañas: un solo intento por destinatario.
• Tiempo máximo de espera a Bird: 8 segundos en WhatsApp y 10 en SMS.

Comprobar que funciona#

1. En Apariencia, «Estado del canal de WhatsApp» dice «Configurado.».
2. Abre el acceso del portal del club, escribe el teléfono de un socio de prueba y comprueba que llega el WhatsApp y que el enlace entra. En su ficha, pestaña «Comunicaciones», aparece «Acceso al portal» por WhatsApp.
3. En la ficha, «Enviar wallet» por WhatsApp: llega el mensaje con los enlaces de la tarjeta.
4. Pon a «Sí» el consentimiento de WhatsApp del socio de prueba, crea una campaña de WhatsApp y usa «Enviar prueba» con tu teléfono.
5. Lanza la campaña a un segmento pequeño y revisa en «Resultados» el estado de cada destinatario.
6. Para SMS, lo mismo con una campaña de canal SMS.

Errores frecuentes y solución#

Preguntas frecuentes#

¿Cómo envío campañas de WhatsApp a los socios del club de fidelización?#

Con la plantilla de notificación de Bird configurada, crea una campaña de canal WhatsApp en Administración → Campañas. Solo llega a los socios con teléfono y «Sí» en el consentimiento de WhatsApp.

¿Puedo enviar los WhatsApp desde el número del restaurante?#

Sí: elige «Bird (cuenta del portal)» y pon las credenciales y plantillas de la cuenta de Bird del club, conectada a su número. Con «Servicio propio» salen desde el número de Connect Manager.

¿Por qué mi campaña de WhatsApp llega a tan pocos socios?#

Porque Meta exige permiso expreso para WhatsApp y solo cuentan los socios con «Sí» en ese canal. El permiso general del portal de registro es del correo.

¿Se pueden mandar WhatsApp sin plantilla?#

No con Bird: solo plantillas aprobadas por Meta. El texto de la campaña va dentro del parámetro de la plantilla de notificación.

¿Sabe Connect Manager si el socio ha leído el WhatsApp?#

No. Solo registra si Bird aceptó el mensaje; no recibe entregas ni lecturas.

Referencias#

• Ficha de WhatsApp en el catálogo
• Ficha de Bird en el catálogo
• Fidelización: conectar el club con Ágora
• Apple Wallet: la tarjeta del club en el iPhone
• Google Wallet: la tarjeta del club en Android
• Proveedores de envío de correo
• Documentación de Bird
• Política de WhatsApp Business