Integración con chatbot

Integra WhatsApp con Typebot usando ZapZap API

Typebot es un constructor visual de código abierto para chatbots conversacionales. En lugar de formularios estáticos, montas un flujo de preguntas y respuestas con bloques que se arrastran: burbujas de texto y medios, campos para capturar datos del visitante y bloques de lógica e integración. El bot conduce la conversación, guarda cada respuesta en variables y te permite publicar el flujo como enlace, incrustación en un sitio o popup. Se usa mucho para captar leads, calificar y hacer onboarding, justamente porque convierte un registro aburrido en un chat natural.

Por qué conectar

Typebot es excelente para captar datos dentro de una conversación, pero por defecto la conversación ocurre en el navegador. Al conectar Typebot con ZapZap API, cada lead que termina el flujo puede recibir de inmediato un mensaje de WhatsApp: una confirmación, el enlace de reserva, un cupón o un primer contacto de un agente. Un escenario concreto: una clínica publica un Typebot que pide nombre, teléfono y el procedimiento de interés. En cuanto el lead responde, el bloque de integración llama a ZapZap API y el WhatsApp de la clínica envía un mensaje de bienvenida personalizado con los próximos pasos. El lead sale del flujo y ya encuentra una conversación abierta en WhatsApp, sin que nadie escriba nada a mano. Como cada número funciona en una instancia gestionada con calentamiento comunitario e IA por instancia, este envío automático ocurre más cerca del comportamiento humano, lo que reduce el riesgo de baneo.

Paso a paso

  1. 1

    Monta el flujo y captura los datos en Typebot

    En el editor de Typebot, arrastra bloques de la categoría Inputs al lienzo: usa el input Text para el nombre y el input Phone number para el teléfono. Typebot guarda cada respuesta en una variable, por ejemplo {{Name}} y {{Phone}}. Verifica los nombres de las variables en el panel Variables, en la esquina del editor.

  2. 2

    Añade el bloque HTTP request

    Abre la paleta de bloques a la derecha, ve a la categoría Integrations y arrastra el bloque HTTP request (antes llamado bloque Webhook) al final del flujo, después de los inputs. Este es el bloque que hablará con ZapZap API cuando el lead termine de responder.

  3. 3

    Configura método, URL y headers

    Haz clic en el bloque HTTP request para abrir sus ajustes. En Method elige POST y en URL pega el endpoint de envío de ZapZap API (base https://api.zapzapapi.com, consulta la ruta exacta en https://api.zapzapapi.com/llms.txt). Abre Headers y añade dos líneas: x-api-key con tu clave y x-api-secret con tu secreto, ambos disponibles en el panel de ZapZap.

  4. 4

    Construye el Body con las variables de Typebot

    Aún en el bloque, ve a Body y selecciona JSON. Escribe el cuerpo haciendo referencia a las variables capturadas con doble llave, por ejemplo el número en {{Phone}} y un mensaje que use {{Name}}. Typebot sustituye los valores reales en el momento del envío. Los nombres exactos de los campos del cuerpo están documentados en https://api.zapzapapi.com/llms.txt.

  5. 5

    Prueba en la vista previa y publica

    Haz clic en Test en la barra superior para ejecutar el flujo en modo vista previa y comprobar que la solicitud sale con estado de éxito (también puedes usar Test the request dentro del propio bloque). Una vez confirmado el envío en WhatsApp, haz clic en Publish para poner el Typebot en vivo como enlace, incrustación o popup.

Ejemplo

// Ejemplo ILUSTRATIVO del Body del bloque HTTP request (POST)
// Los campos exactos están en la documentación: https://api.zapzapapi.com/llms.txt
//
// URL:    https://api.zapzapapi.com/api/v1/{instanceId}/send/text   (endpoint ilustrativo)
// Method: POST
// Headers:
//   x-api-key: TU_API_KEY
//   x-api-secret: TU_API_SECRET
//   Content-Type: application/json
//
// Body (JSON) con variables de Typebot:
{
  "number": "{{Phone}}",
  "text": "Hola {{Name}}, recibimos tu contacto y te atenderemos por aquí en breve."
}

Ilustrativo. Los campos y endpoints exactos están en la documentación.

Preguntas frecuentes

¿Necesito la API oficial de WhatsApp Business para usarlo con Typebot?

No. ZapZap API funciona con instancias de WhatsApp no oficiales y gestionadas. Conectas tu número leyendo un QR en el panel y empiezas a enviar y recibir mensajes por REST, sin necesidad de aprobar plantillas ni pasar por el proceso oficial de Meta.

¿Cómo se autentica Typebot en ZapZap API?

La autenticación se hace con dos headers en el bloque HTTP request: x-api-key y x-api-secret. Generas este par en el panel de ZapZap y lo pegas en los Headers de la solicitud. Sin ellos, la llamada es rechazada.

¿Puedo recibir de vuelta en el flujo las respuestas de WhatsApp?

Typebot es el disparador de salida: envía el mensaje cuando el lead termina el flujo. Para reaccionar a los mensajes que llegan a WhatsApp, ZapZap API envía eventos por webhook, que puedes tratar en una automatización aparte (n8n, Make o tu backend). Los eventos disponibles están en https://api.zapzapapi.com/llms.txt.

¿Cuánto cuesta mantener esto funcionando?

ZapZap cobra R$15 por número activo al mes, con modelo prepago, y empiezas con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente. Typebot tiene un plan gratuito y planes de pago propios. La integración en sí, mediante el bloque HTTP request, no tiene costo adicional.

¿Enviar un mensaje automático a cada lead puede hacer que baneen mi número?

El envío automático en volumen siempre requiere cuidado. ZapZap trabaja con calentamiento comunitario, recursos antibaneo e IA por instancia para que el comportamiento sea más natural, lo que reduce el riesgo. Aun así, usa mensajes relevantes y evita el envío masivo a contactos que no pidieron ser contactados.

Empieza ahora

Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.