ChatCieloDocs

Catálogo de Bloques e Interacciones

Guía completa de las interacciones disponibles: mensajes, enrutamiento, CRM e integraciones

Catálogo de Bloques e Interacciones

Cada bloque en el canvas puede contener una o varias interacciones. El bot las ejecuta en orden, de arriba hacia abajo. Conoce todos los tipos disponibles para combinar mensajes, lógica y acciones de CRM.

Bloques disponibles

Mensajes

Mensaje de texto

Envía texto con soporte para variables y emojis. Usa {{name}} para personalizar.

  • Ejemplo: {{greeting}} {{name}}, ¡bienvenido a ChatCielo! ¿En qué puedo ayudarte hoy?
  • Tip: Mantén mensajes de 2–3 líneas para lectura en móvil.

Multimedia

Envía imagen, audio, video o documento. Puedes subir archivo o usar URL pública.

  • Usos: catálogos, comprobantes, instrucciones visuales.

Botones

Hasta 3 botones de respuesta rápida. Cada botón genera una conexión por palabra clave automática.

  • Ejemplo: [Agendar] [Soporte] [Hablar con humano]
  • Ventaja: reduce errores de escritura y facilita el enrutamiento.

Lista (List Message)

Menú desplegable con hasta 10 opciones y secciones. Ideal para menús extensos.

  • Cuándo usar: cuando 3 botones no alcanzan.

Plantilla (HSM / WABA Template)

Envía una plantilla aprobada por Meta. Necesaria fuera de la ventana de 24 horas.

  • Requisito: plantilla previamente aprobada en Canales > Plantillas.

Sticker, Contacto, Ubicación

  • Sticker: envía un sticker estático.
  • Contacto: comparte un contacto vCard.
  • Ubicación: envía coordenadas con nombre y dirección.

Videoconferencia

Genera un enlace de videollamada (Meet/Jitsi) y lo envía al cliente.

Botón PIX

Botón de pago PIX (Brasil) con valor y clave configurables.

Enrutamiento

Transferir

Deriva la conversación a una cola, usuario o equipo específico.

Coloca Transferir siempre al final del bloque, después de mensajes y acciones de CRM. Si lo pones antes, las acciones siguientes pueden no ejecutarse.

Subflujo

Llama a otro flujo como subrutina. Útil para reutilizar lógicas (ej. validación de horario).

Retardo (Delay)

Espera N segundos antes de la siguiente interacción. Simula escritura humana.

  • Recomendado: 1–2 segundos entre mensajes largos.

Bloquear Chatbot

Evita que el bot siga respondiendo tras una transferencia o cierre.

Sin Bloquear Chatbot, el bot puede seguir interceptando mensajes aunque el ticket ya esté con un agente. Añádelo siempre después de Transferir cuando quieras entregar a humano.

Integraciones

Webhook

Hace una petición HTTP (GET/POST) a tu sistema y puede usar la respuesta para decidir el siguiente paso.

  • Ejemplo: consultar stock o validar DNI antes de continuar.

Webhook Avanzado

Webhook con mapeo de campos, headers personalizados y manejo de respuesta JSON con variables.

ChatGPT / IA

Conecta con OpenAI para respuestas generativas. Puedes inyectar contexto del contacto con {{name}} y {{phoneNumber}}.

Typebot

Incrusta un flujo de Typebot dentro de ChatFlow.

n8n

Dispara un workflow de n8n y espera su retorno.

VAPI (Voz)

Integra asistentes de voz VAPI para llamadas automatizadas.

SMS

Envía un SMS externo vía proveedor configurado.

CRM y Acciones

Etiqueta

Añade o quita etiquetas del contacto/conversación. Útil para segmentar y filtrar.

  • Ejemplo: etiqueta interes-agendamiento al elegir opción 1.

Kanban / Embudo

Mueve la oportunidad a una etapa del pipeline de ventas.

Oportunidad

Crea o actualiza una oportunidad en el CRM con valor, responsable y etapa.

Notas

Añade una nota interna al contacto u oportunidad. Soporta {{name}} y {{email}}.

Agendamiento

Crea un agendamiento/cita con fecha, hora y responsable.

Consulta de Agenda

Verifica disponibilidad antes de agendar.

Google Agenda

Sincroniza con Google Calendar para crear/buscar eventos.

Variables en interacciones

Todas las interacciones de mensaje soportan variables. Ejemplos:

  • {{greeting}} {{firstName}}, tu protocolo es {{protocol}}.
  • Gracias {{name}}, confirmamos en {{email}}.
  • Te atiende {{user}} en el número {{phoneNumber}}.

Recuerda documentar variables siempre entre backticks: {{name}}, {{firstName}}, {{protocol}}, {{greeting}}, {{user}}, {{email}}, {{phoneNumber}}.

Orden recomendado dentro de un bloque

  1. Mensajes y retardos.
  2. Acciones de CRM (etiqueta, kanban, oportunidad, notas).
  3. Integraciones externas (webhook, IA).
  4. Transferencia y Bloquear Chatbot al final.

Este orden garantiza que el cliente vea el mensaje antes de que el ticket se mueva y que las integraciones tengan tiempo de ejecutarse.

Siguientes pasos