Conectar un negocio

Cómo el comercio (cliente final tuyo) conecta su WhatsApp con Sabado Cloud usando el flow oficial de Meta de Embedded Signup — con o sin coexistencia con su WhatsApp Business app.

Embedded Signup

Cuando registrás un negocio nuevo en Tus negocios, te damos un link único:

https://waba.galgo.io/connect/TU_CUENTA/IDENTIFICADOR_DEL_NEGOCIO

Cuando el negocio entra al link, hace tres cosas:

  1. Login con su cuenta de Facebook (la que administra su WhatsApp).
  2. Selecciona o crea su WhatsApp Business Account.
  3. Acepta los permisos para que Sabado Cloud envíe y reciba mensajes en su nombre.

Cuando termina, en tu panel el negocio aparece como conectado y ya podés enviar mensajes a través de la API. También empezás a recibir message.received cuando el cliente final le escribe.

Te conviene chequear el estado del negocio antes de mandar mensajes para no recibir 409 tenant_not_connected — si el cliente abandonó el flow o falló algo, no se persisten credenciales (o queda marcado como no-conectado).

Coexistence vs migration

La vista de Embedded Signup ofrece dos opciones al usuario. La elección la hace el dueño del comercio — vos como consumer no la controlás. En ambos casos el resultado para tu lado es el mismo: el negocio queda conectado y empezás a recibir mensajes.

Coexistence (default, recomendado)

La WhatsApp Business app del cliente sigue funcionando en su celular y nuestra Cloud API recibe los mismos mensajes en paralelo. Es lo que vas a ver casi siempre — es el flow que onboardea clientes reales en producción hoy.

El cliente mantiene su forma de trabajar con WhatsApp del celular sin perder funcionalidad; tu integración recibe los mismos mensajes vía la API.

Migration (opción avanzada con confirmación strict)

El número se migra a Cloud API y la WhatsApp Business app del celular deja de funcionar para ese número. Revertir requiere ticket a Meta y suele tardar días.

Por la irreversibilidad, esta opción no se llega por accidente: el cliente tiene que escribir literalmente "migrar" en un campo de un modal de confirmación. Sin esa tecleada, el botón de confirmar queda deshabilitado.

Por qué la guard. Sin ella, un cliente que quería coexistence podía terminar migrando su número por accidente y perdía el uso de WhatsApp Business app en el celular de un día para el otro. El modal con confirmación textual existe específicamente para que la migración sea siempre un acto deliberado.

Cuando el callback de Sabado recibe el resultado del Embedded Signup, incluye un campo flow: "coexistence" | "migration" en el log interno para que podamos auditar quién migró. No impacta en lo que tu integración recibe.