WhatsApp listo con un solo enlace


Cargando el mapa interactivo…

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

  1. 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.
  2. 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.
  3. 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.
  4. 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/.
  5. 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.
  6. 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.
  7. 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.
  8. 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.

¿Necesitas ayuda?