Cómo integrar Whaticket con Zapier y Typeform

Con Typeform, Zapier y la API de Whaticket, cada persona que responde un formulario recibe al instante un mensaje de WhatsApp y aparece como chat en tu cuenta. Zapier recibe la respuesta de Typeform y llama a la API de Whaticket, que envía el mensaje por la conexión que elijas.

Qué cambia en tu operación

El primer contacto con cada lead sale automáticamente, sin que nadie copie datos del formulario.
El chat puede nacer asignado a un agente o a un departamento.
Los datos del formulario se convierten en contacto en Whaticket.

Antes de empezar

Una cuenta en Typeform con al menos un formulario publicado y una respuesta de prueba.
Una cuenta en Zapier.
Tu perfil en Whaticket necesita el permiso Crear del grupo Tokens de API para generar el token.
El perfil elegido para el token necesita los permisos Crear e Iniciar del grupo Campañas. Con ellos la API envía mensajes.
Si la conexión es WhatsApp QR Code, cada mensaje enviado por la API consume créditos de campaña. Revisa tu saldo antes de activar la automatización.

Paso a paso:

Crea el token de API en Whaticket

En el menú de la izquierda, haz clic en Integraciones.
En la pestaña Tokens, haz clic en Nuevo token.
Ponle un Nombre al token, como “Zapier Typeform”, y elige el Perfil. El token hereda los permisos de ese perfil.
Guarda y copia la clave en la ventana Copia la clave del token. Solo aparece una vez. Si la pierdes, usa Regenerar para crear una nueva.

Copia los IDs que usa la solicitud

En Conexiones, haz clic en Editar en la conexión que enviará los mensajes y haz clic en el ícono de copiar junto al título Edita Conexión. Ese es el ID de la conexión.
Si quieres asignar el chat a un agente, abre Equipo, edita el usuario y copia el ID con el ícono junto al título.
Si quieres dirigir el chat a un departamento, abre Departamentos & Chatbots, edita el departamento y copia el ID con el ícono Copiar identificación.

Prepara el formulario en Typeform

Entra a Typeform y crea un formulario o usa una plantilla.
Incluye al menos los campos de nombre y número de WhatsApp.
Publica el formulario y envía una respuesta de prueba. Zapier usa esa respuesta para reconocer los campos.

Crea el Zap y configura el disparador

En Zapier, abre Zaps y haz clic en Create.
Elige la app Typeform y el evento New Entry.
Conecta tu cuenta de Typeform, selecciona el formulario y haz clic en Continue.
Prueba el disparador y revisa que el nombre y el teléfono aparezcan en los datos capturados.

Formatea el número de teléfono

Agrega un paso con la app Formatter by Zapier y el evento Text.
En Transform, elige Replace.
En Value, selecciona el teléfono del formulario. En Find, escribe + y deja Replace vacío.
Prueba el paso y revisa en Data Out que el número salga sin el +.

La API de Whaticket solo acepta números con dígitos, en formato internacional con código de país y de área, por ejemplo 5491122223333. El número no puede empezar con 0.

Configura la llamada a la API de Whaticket

Agrega un paso con la app Webhooks by Zapier y el evento Custom Request.
En Method, elige POST.
En URL, ingresa https://api.whaticket.com/api/v1/messages.
En Data Pass-Through, elige false y, en Unflatten, elige Yes.
En Headers, agrega Content-Type con el valor application/json y Authorization con el valor Bearer seguido de un espacio y la clave del token.

En el campo Body, pega el JSON de abajo y reemplaza los valores por los datos del formulario con el botón + de Zapier:

{
  "connectionId": "ID_DE_TU_CONEXION",
  "messages": [
    {
      "number": "telefono_sin_mas",
      "name": "Nombre del contacto",
      "body": "Mensaje que se enviará al contacto",
      "ticketData": {
        "userId": "ID_DEL_USUARIO",
        "queueId": "ID_DEL_DEPARTAMENTO",
        "status": "open",
        "keepAssigned": true,
        "keepAssignedUntil": "2026-12-31",
        "force": true
      }
    }
  ]
}

connectionId: ID de la conexión que envía el mensaje. El campo antiguo whatsappId todavía se acepta.
number: teléfono del formulario, ya sin el +.
name: nombre del contacto, con al menos 3 caracteres. Se usa para crear el contacto si todavía no existe.
body: texto del mensaje.
ticketData: opcional. Define el agente (userId), el departamento (queueId) y el estado del chat (open, pending o closed).
keepAssigned y keepAssignedUntil: opcionales. Mantienen el chat con el mismo agente cuando el contacto responda. Requieren userId, y la fecha debe ser futura, en formato AAAA-MM-DD.

Prueba y activa el Zap

Haz clic en Test.
Si todo está bien, la respuesta trae messages scheduled.
Si aparece un error, Zapier muestra el motivo. Corrígelo y vuelve a probar.
Haz clic en Turn on para activar el Zap.

Preguntas frecuentes

¿Dónde aparece el contacto en Whaticket?
Como chat de la conexión elegida. Con ticketData, va al agente o departamento indicado, en el estado que definiste. Sin ticketData, el chat se crea como resuelto.

¿La API rechaza el envío si no tengo créditos?
No. La respuesta cambia messages scheduled por un aviso con tu saldo, y los mensajes que consumen crédito quedan esperando hasta que agregues créditos.

¿Qué conexiones consumen créditos?
Solo WhatsApp QR Code. Las conexiones WhatsApp API Cloud y Coexistencia no consumen créditos, pero exigen una plantilla aprobada en el campo templateId.

¿Dónde veo todos los campos de la API?
En Integraciones, pestaña Documentación. Ahí también puedes probar las llamadas.

¿Los créditos vencen?
No. Los créditos no tienen fecha de vencimiento.

¿Quién responde por errores en la integración?
Whaticket no se responsabiliza por errores de configuración, falta de créditos o costos de las plataformas externas usadas en la integración. Si es posible, cuenta con un desarrollador para validar el mapeo de campos y el JSON.