Conectar WhatsApp (pedidos con IA y avisos)

Tu número conectado a la API oficial de Meta, paso a paso y sin saber nada técnico: con capturas, los links exactos y los errores típicos resueltos.

Podés empezar hoy con el número compartido de Zafo (cero trámite, solo enviar) y conectar tu propio número de WhatsApp Business cuando quieras: con tu número los mensajes salen con tu marca, podés escribirle primero al cliente y los mensajes que TE mandan entran solos como pedidos. La conexión se hace desde Ajustes → Conexiones → WhatsApp: el asistente te lleva de la mano por estos mismos pasos, valida cada dato en vivo y termina mandándote un mensaje de prueba real. Esta guía es el mapa completo por si querés ver todo antes, o si te trabás en algún paso.

Antes de empezar

Una cuenta de Facebook (la tuya sirve) · 20 minutos, una sola vez · Para tu número real: un número que NO esté activo en la app común de WhatsApp (o usá primero el número de prueba gratis de Meta)

Paso a paso

  1. Creá tu app en Meta (el “enchufe”)Entrá a developers.facebook.com/apps/create con tu cuenta de Facebook. Nombre de la app: el de tu negocio. Caso de uso: Otro → tipo Negocios. Tocá Crear app. Es gratis y no hay que programar nada.
    developers.facebook.com/apps/create/MMeta for DevelopersMis apps › Crear appCrear una appCompletá los datos y elegí el caso de usoNombre de la appMi Comercio (o el nombre de tu negocio)Email de contactovos@tunegocio.comCaso de usoOtroTipo: NegociosCrear app
    Así se ve en Meta (recreación simplificada) — el círculo naranja marca dónde ir
  2. Agregale WhatsApp a la appEn el panel de tu app aparece una grilla de productos: buscá la tarjeta WhatsApp y tocá Configurar. Si te pide una “cuenta comercial”, aceptá la que te sugiere. Meta te regala un número de prueba para arrancar ya mismo.
    developers.facebook.com/apps/…/dashboardMMeta for DevelopersMi Comercio › PanelAgregá productos a tu appMessengerConectá tu app coneste producto de Meta.ConfigurarWhatsAppMensajes, plantillas yla Cloud API oficial.ConfigurarWebhooksConectá tu app coneste producto de Meta.ConfigurarBuscá la tarjeta de WhatsApp y tocá “Configurar”.
    Así se ve en Meta (recreación simplificada) — el círculo naranja marca dónde ir
  3. Copiá las dos llaves y pegalas en ZafoEn WhatsApp → Configuración de la API están el token de acceso (la llave) y el Identificador del número de teléfono (el “Phone number ID”, ~15 dígitos — NO es tu número de teléfono). Pegalos en Zafo (Ajustes → Conexiones → WhatsApp, paso 3): el asistente los prueba contra Meta al instante y te dice “✓ Conectado” con el nombre y número de tu cuenta, o el error explicado.
    developers.facebook.com/apps/…/whatsapp-business/wa-dev-consoleMMeta for DevelopersWhatsApp › Configuración de la APIPanelConfiguración de la APIWebhooksPlantillasToken de acceso temporalDura 24 horas — sirve para probar. Para producción, generá uno permanente.EAAG…8ZD (token larguísimo — copialo entero)CopiarSi vence, volvés a esta pantalla y generás otro (o hacés el permanente, paso 5 de la guía).Enviar y recibir mensajesDe+54 9 11 5555-0000 (prueba)Identificador del número de teléfono123456789012345Ese identificador es el “Phone number ID” que te pide Zafo (no es el número de teléfono).
    Así se ve en Meta (recreación simplificada) — el círculo naranja marca dónde ir
  4. Activá el timbre (webhook) para recibir mensajesEn WhatsApp → Configuración → Webhook → Editar pegá los dos valores que te da el asistente de Zafo (la URL y TU token de verificación, que Zafo genera solo), tocá Verificar y guardar y suscribite al campo messages. En Zafo vas a ver aparecer “✓ Webhook verificado” en vivo. Sin este paso podés enviar igual; hace falta para RECIBIR.
    developers.facebook.com/apps/…/whatsapp-business/wa-settingsMMeta for DevelopersWhatsApp › ConfiguraciónWebhookEl “timbre”: Meta le avisa a Zafo cada mensaje nuevo. Pegá los dos valores que te da el asistente.URL de devolución de llamada (Callback URL)https://www.zafo.app/api/webhooks/whatsappToken de verificaciónzafo-a1b2c3…Verificar y guardarCampos del webhookSuscribite al campo “messages”: sin eso, los mensajes no llegan.messagesSuscrito
    Así se ve en Meta (recreación simplificada) — el círculo naranja marca dónde ir
  5. Hacé el token permanente (para que no se corte)El token de la pantalla anterior es temporal: dura 24 horas. Para el definitivo: Configuración del negocio → Usuarios del sistema → Agregar → creale un token con tu app y los permisos whatsapp_business_messaging y whatsapp_business_management, vencimiento “Nunca”. Pegá ese token en Zafo en lugar del temporal.
    business.facebook.com/settings/system-usersMMeta for DevelopersConfiguración del negocio › Usuarios del sistemaUsuarios del sistemaUn “usuario robot” para tu negocio: sus tokens no vencen nunca. Se hace una sola vez.Agregarzafo-botAdministrador · creado por vosGenerar nuevo tokenAl generar el token:1. App: elegí TU app (la que creaste en el paso 1)2. Vencimiento: “Nunca”3. Permisos: whatsapp_business_messaging4. Permisos: whatsapp_business_managementCopiá el token generado y pegalo en Zafo en lugar del temporal. No se vuelve a mostrar: guardalo bien.
    Así se ve en Meta (recreación simplificada) — el círculo naranja marca dónde ir
  6. Mandate el mensaje de pruebaÚltimo paso del asistente: ponés tu número (con código de país, ej. 549…) y Zafo te manda un WhatsApp real. Si llegó, quedó todo conectado: avisos, cobros y pedidos entrantes.

¿Qué es todo esto? (en criollo)

  • La app de Meta = el enchufe. Un “cajoncito” en Meta que conecta tu número con Zafo. Se crea una vez y no se toca más. No es una app que haya que programar ni publicar.
  • El token = la llave. Una clave larguísima que le permite a Zafo enviar mensajes por tu número. El temporal vence a las 24 hs; el permanente (usuario del sistema) no vence nunca.
  • El Phone number ID = qué teléfono. El número de serie interno de tu línea en Meta (~15 dígitos). Meta lo usa en vez del número “humano”.
  • El webhook = el timbre. La forma en que Meta le avisa a Zafo que te llegó un mensaje: le “toca timbre” a una URL de Zafo. El token de verificación demuestra que ese timbre es tuyo.
  • La WABA = la carpeta del negocio. WhatsApp Business Account: agrupa tus números y plantillas. Zafo la usa para leer tus plantillas aprobadas (opcional).

Consejos

  • El número de prueba de Meta sirve para probar todo el circuito gratis, pero solo manda a destinatarios que agregues a la lista de permitidos (Meta → Configuración de la API → “Para”). Tu número real no tiene ese límite.
  • La ventana de Meta: con tu número podés iniciar conversaciones con plantillas aprobadas (recordatorios, cobranzas). El texto libre vale dentro de las 24 hs del último mensaje del cliente.
  • El agente IA (guía aparte) convierte este canal en un vendedor 24/7; la lectura de pedidos con IA arma borradores desde cada mensaje entrante.

Preguntas frecuentes

Andaba y al día siguiente dejó de andar. ¿Qué pasó?

Casi seguro usaste el token temporal, que vence a las 24 horas. Generá el permanente con un usuario del sistema (paso 5) y pegalo en Zafo: ese no vence.

Meta dice “no se pudo validar la URL de devolución de llamada”.

Revisá que la URL sea EXACTA (copiala con el botón de Zafo, empieza con https://) y que el token de verificación sea el que te muestra el asistente, sin espacios ni comillas. Después tocá de nuevo “Verificar y guardar”.

El mensaje de prueba no llega.

Si usás el número de prueba de Meta: tu número tiene que estar en la lista de destinatarios permitidos. Además el destino va con código de país y sin el 15 (ej: 5491155550000). Si el token venció, el asistente te lo dice al validar.

¿Puedo usar el número que ya tengo en el WhatsApp de mi teléfono?

Ese número tiene que darse de baja de la app común primero (la API y la app no conviven en el mismo número). Alternativas: un número nuevo/línea fija para la API, o empezar con el número de prueba de Meta.

¿La IA carga pedidos sola sin que yo mire?

Arma el pedido como borrador con el mensaje original al lado; vos confirmás o corregís. Con alias bien cargados, casi siempre es solo confirmar.

¿Zafo ve mis chats personales?

No. La conexión es solo del número de negocio que vos conectás, y solo de los mensajes que llegan a ese número.

Seguir leyendo
Conectar WhatsApp (pedidos con IA y avisos): guía paso a paso · Zafo