WhatsApp listo con un solo enlace
Armas un flow que sirve de plantilla y lo eliges una sola vez. Los canales que necesita (WhatsApp, Gmail…) se detectan solos: son los nodos de WhatsApp, Gmail, Google Calendar o Jira, tengan o no un recurso tuyo puesto. Desde entonces, cada cliente que conecte esos canales recibe su propia copia del flow, con todos sus canales asignados, y la copia se activa sola cuando ya los tiene todos. El primer mensaje que reciba ya la ejecuta. Ningún cliente elige ni ve nada: los enlaces de conexión son los de siempre.
¿Cuándo usarlo?
Cuando quieres que cada cliente conecte sus canales y quede atendido de inmediato con su propio flow, sin que asignes recursos ni enciendas nada a mano.
Pasos
- 1Arma y prueba el flow que será la plantilla, con los canales que necesite: por ejemplo un trigger de WhatsApp y un nodo que envía por Gmail. Puedes dejar tu propio WhatsApp o Gmail puesto (es tu prueba): cada cliente lo reemplaza con el suyo y el tuyo no se copia. Si el flow usa otros recursos tuyos que el cliente no conecta (por ejemplo tu OpenRouter), déjalos asignados: se copian tal cual a cada réplica y no se le piden al cliente. La plantilla nunca se enciende: solo se copia.
- 2Copia el id de la plantilla. Lo obtienes con GET https://api.pulbot.com/api/v1/flows/ (header X-API-Key); es el campo id de tu flow.
- 3Comprueba tu saldo y tu plan. Activar un flow en producción exige saldo en tu wallet, y cada réplica cuenta como un flow activo de tu plan.
- 4Elige la plantilla, una sola vez. En el panel: Recursos → «Plantilla para recursos nuevos», elige el flow y pulsa Guardar: te muestra los canales que detectó («Cada cliente conectará: WhatsApp, Gmail») y la deja marcada como «Activa»; ahí mismo ves qué pasó con el último cliente. Por API: PUT https://api.pulbot.com/api/v1/flows/auto-connect/ con el header X-API-Key y el cuerpo {"flow_id": "ID_DE_LA_PLANTILLA"} (no indicas canales: salen del flow); GET /api/v1/flows/auto-connect/ la lista. Para cambiarla, elige otro flow; para quitarla, «Quitar plantilla» o DELETE /api/v1/flows/auto-connect/ID_DE_LA_PLANTILLA/.
- 5Genera un enlace por cada canal del cliente, como siempre y sin ningún flow, y en TODOS manda el mismo external_ref (tu id del cliente): así sus canales caen en la misma copia. Para WhatsApp: POST /api/v1/connection-links/ con {"provider": "whatsapp", "external_ref": "cliente-123", "customer_email": "ana@negocio.com", "customer_name": "Ana"}; para Gmail: lo mismo con {"provider": "google", "external_ref": "cliente-123"}. customer_email y customer_name son opcionales: con ellos, Pulbot le avisa a Ana por correo cuando termine. Cada uno responde 201 con data.connect_url; entrégalos a tu cliente. Vencen a los 10 minutos y sirven para una sola conexión.
- 6Tu cliente abre cada enlace, pulsa conectar y autoriza en Meta o en Google. No necesita cuenta en Pulbot, no escribe su correo ni elige nada: solo ve que quedó conectado. Si conecta un canal y el otro todavía no, su copia queda esperando; cuando llega el último, se enciende sola.
- 7Verifica el resultado: GET /api/v1/flows/auto-connect/ devuelve la plantilla con last_result: el flow_id de la réplica de ese cliente, assigned, activated, pending_platforms (los canales que aún faltan) y, si algo falló, reason. Abre esa réplica en el panel para confirmar que está activa.
- 8Prueba de verdad: escribe un mensaje al canal conectado (por ejemplo, un WhatsApp al número) y confirma que su réplica responde. Mira la ejecución en el historial de esa réplica antes de dar la integración por lista.
Referencia
- Qué hace Pulbot al conectarse un número
- En este orden, cada vez que un cliente conecta uno de los canales de la plantilla: 1) se crea el recurso; 2) se replica la plantilla en un flow nuevo para ese cliente (solo la primera vez; sus otros canales reutilizan la misma réplica); 3) se asigna el recurso como canal en los nodos de esa plataforma; 4) si la réplica ya tiene todos sus canales, se activan sus triggers; si falta alguno, espera. Cada paso solo corre si el anterior salió bien.
- La plantilla
- Una por cuenta; una plataforma pertenece a una sola plantilla. Se elige en el panel (Recursos → «Plantilla para recursos nuevos») o con PUT /api/v1/flows/auto-connect/ y {"flow_id": "…"}. Tienes que poder editar ese flow y debe tener al menos un canal que el cliente conecte (un nodo de WhatsApp, Gmail, Google Calendar o Jira).
- Plantilla y réplicas
- La plantilla nunca se asigna ni se enciende. Cada cliente (su external_ref) recibe UNA réplica propia, con su nombre, independiente de las demás, y todos sus canales caen en ella. Si tu cliente repite una conexión con el mismo external_ref se actualiza el mismo recurso y no se crea otra réplica.
- Recursos compartidos
- Los recursos tuyos que usa la plantilla y no son el WhatsApp del cliente (por ejemplo OpenRouter) se copian a cada réplica tal cual.
- Un cliente = su external_ref
- Las réplicas son una por cliente, y el cliente es su external_ref. Con el mismo external_ref, su WhatsApp y su Gmail van a la misma réplica. Sin external_ref cada recurso cuenta como un cliente aparte: sirve para flows de un solo canal, pero un flow con varios canales necesita el external_ref en cada enlace.
- Varios canales
- La réplica espera a tener TODOS sus canales: mientras falte alguno, last_result trae reason = waiting_for_channels y pending_platforms con los que faltan; el último recurso que llega la enciende. No es un error.
- Dónde se aplica
- A todo recurso nuevo de las plataformas de la plantilla: por el enlace de conexión (WhatsApp, Google…), por tu propio botón, por el panel o por POST /api/v1/resource-connectors/. Un recurso que nace pendiente y pasa a activo también la sigue. Los recursos que ya existían no se tocan.
- Aviso por correo al cliente
- Si mandaste customer_email al crear el enlace, cuando el cliente termina Pulbot le envía un correo: «tu asistente ya está atendiendo» si su réplica quedó activa, o «tu WhatsApp quedó conectado, estamos terminando de activarlo» si no (por saldo, plan u otra causa; el cliente no ve el motivo, tú sí en last_result). Sin customer_email no se envía nada. El correo lo manda un flow del sistema de Pulbot, así que el texto y los canales se cambian desde el orquestador. Hoy el aviso es solo por correo.
- Editar la plantilla
- Una réplica es un flow aparte: si editas la plantilla después, las réplicas que ya existen NO cambian. Las nuevas sí nacen de la versión actual.
- Secretos
- Una clave escrita a mano en la configuración de un nodo no viaja a la réplica (se redacta al copiar). Conecta la clave como recurso y asígnala en la plantilla.
- Si algo falla
- La conexión NO se deshace: el recurso queda creado y tu cliente no tiene que autorizar otra vez. El motivo queda en last_result.reason y, si la réplica llegó a crearse, su id en last_result.flow_id. Corrige la causa y activa esa réplica desde el panel.
- insufficient_funds
- No hay saldo en la wallet para activar la réplica. Recarga y actívala desde el panel.
- plan_limit
- Tu plan alcanzó el máximo de flows activos (cada réplica cuenta como uno). Desactiva otro flow o cambia de plan.
- channel_in_use
- Ya hay un flow en producción para ese número y ese trigger. Solo puede haber uno.
- clone_failed
- No se pudo replicar la plantilla (por ejemplo, no pasa la validación del flow). Abre la plantilla y corrígela; el recurso quedó creado.
- flow_without_channel / flow_without_trigger
- La plantilla no tiene un nodo del canal de ese recurso al que asignarlo, o no tiene un trigger que activar. Revísala.
- flow_missing / connector_not_ready
- La plantilla de la regla ya no existe, o el recurso todavía no está activo. En el segundo caso, la regla se aplica cuando el recurso pase a activo.
- assign_failed / activation_failed / rule_failed
- No se pudo asignar el canal o activar la réplica por otra causa. Abre la réplica en el panel: ahí se ve qué falta.
- Plantillas de Meta
- Al conectar el número, Pulbot pide a Meta las plantillas de aviso que tu flow necesite. Meta las aprueba por separado y puede tardar: los avisos con plantilla empiezan cuando la aprueba.
Errores comunes
- 401
- La API key falta, se revocó o venció.
- «Este enlace ya no sirve»
- El enlace venció o ya se usó. Pide uno nuevo.
- La réplica quedó apagada
- Mira last_result.reason en GET /api/v1/flows/auto-connect/ y la tabla de arriba. Casi siempre es saldo o el límite del plan.
- No llega el correo al cliente
- Revisa que mandaste customer_email al crear el enlace (un correo inválido responde 422) y que el flow del sistema «Pulbot · Aviso al cliente de conexión terminada» esté activo con la conexión de correo de Pulbot asignada. Si no está activo, el aviso se descarta sin error.
- 404 al elegir la plantilla
- El flow_id no existe o tu usuario no puede editar ese flow.
- 422 al elegir la plantilla
- El flow no tiene canales por conectar: agrega un nodo de WhatsApp, Gmail, Google Calendar o Jira.
Siguiente paso
Continúa con API → Armar flows por API para construir la plantilla, o con Conectar recursos con un enlace para los demás proveedores.