Visión general
La plantilla Chatbot completo: menú, preguntas, negocio en CRM y tareas entrega un asistente automático de punta a punta, listo para producción, que se adapta solo al canal de la conversación:
- En canales con mensajes interactivos (WhatsApp, chat del sitio, Telegram, Messenger, Instagram y API), el menú se muestra como botones.
- En canales de solo texto (correo, SMS), el mismo menú se convierte automáticamente en una lista numerada — y el contacto puede responder con el número ("2"), con el texto de la opción o tocando el botón: todas las formas funcionan.
Todo el contenido (mensajes, botones e incluso las palabras clave de comprensión) se crea en el idioma de tu cuenta — español, portugués o inglés.
Requisitos previos
- Flow Builder activo y permiso de Admin para editar y publicar.
- CRM y Tareas activos para ejecutar todos los caminos de la plantilla.
- Una bandeja configurada y un equipo con un agente elegible para la transferencia humana.
Paso a paso
- Abre Flujos → Plantillas y elige Chatbot completo.
- Aplícala y revisa mensajes, palabras clave y el embudo predeterminado del CRM.
- Comprueba
lead_name,lead_email,lead_need,lead_valoryduvidaen el panel de datos. - Usa Ejecutar prueba con una conversación de prueba y recorre ventas, soporte y transferencia.
- Publica y vincula el flujo a las bandejas solo después de validar todas las salidas.
Configuración y opciones
- Menú inicial con tres caminos: Cotización y ventas · Soporte y dudas · Hablar con un agente.
- Camino de ventas — pregunta el nombre, el correo (validado), la necesidad y el valor en mente
(solo números). Con las respuestas:
- crea un negocio en el CRM (embudo predeterminado) titulado "Oportunidad — {nombre}", con el valor indicado y prioridad alta;
- registra una nota en el negocio con todas las respuestas mapeadas;
- abre una tarea "Enviar la cotización a {nombre}" con plazo de 1 día;
- confirma al contacto y lo transfiere a un humano.
- Camino de soporte — pregunta la duda y responde automáticamente FAQs de precio y de horario; cualquier otra duda se convierte en tarea y pasa a un agente.
- Agente humano — la opción 3 transfiere directamente, en cualquier momento.
- Sin respuesta válida — tras 2 reintentos guiados, el contacto pasa a un humano (nunca queda atascado).
Casos de uso
- Calificación de leads con negocio, nota y tarea de seguimiento.
- Triaje de soporte con respuestas rápidas y escalamiento de preguntas no reconocidas.
- Un único menú omnicanal para WhatsApp, chat web, correo y SMS.
Consejos, límites y buenas prácticas
- Los botones y las listas numeradas comparten los mismos elementos: editar el menú una vez actualiza el comportamiento en todos los canales.
- Las respuestas de FAQ casan por palabras clave en el idioma de la cuenta (ej.: "precio", "cuesta") — agrega las tuyas en los nodos de condición.
- El valor indicado entra al negocio en unidades enteras (4900 = $4.900,00).
- Los controles interactivos dependen de la capacidad comprobada del canal; configura siempre el respaldo de texto.
Solución de problemas
- Si una acción se omite, revisa el trace y confirma que CRM/Tareas estén activos y que el objetivo exista.
- Si falla la transferencia, confirma que el equipo pertenezca a la cuenta y tenga un agente elegible.
- Si una respuesta no coincide, revisa el tipo de entrada, las opciones y el límite de reintentos de la espera.
Ver también
- Flow Builder: crear flujos conversacionales visualmente
- Flow Builder: datos del disparador, mapeo y transformación
- Flow Builder: formularios de acción
Respuestas HTTP grandes e idempotencia
En HTTP request, desactiva Guardar la respuesta completa para guardar solo los campos de Mapeo de respuesta. El cuerpo bruto y la variable principal no se guardan en la sesión ni en el historial. Los flujos existentes mantienen el valor predeterminado activado. En este modo, el total leído de la API, incluidas las páginas, está limitado a 1 MiB; los valores mapeados suman hasta 256 KiB. Un campo excesivo queda vacío con un aviso y se conservan los campos pequeños. Los límites de salida del nodo y estado de la sesión siguen activos. La prueba de solicitud sigue mostrando la respuesta para configurar el mapeo.
En Cabeceras de idempotencia, usa X-Idempotency-Key o Idempotency-Key con una clave estable por operación. La autenticación y las demás cabeceras pertenecen a la credencial del almacén. Una clave no garantiza que la API externa admita idempotencia. Un timeout o fallo después de una consulta pagada no confirma que no se haya cobrado: trata la salida de error sin repetir automáticamente la solicitud.
Timeout HTTP ampliado por cuenta
El timeout predeterminado sigue en 15 segundos, con un límite de 30 segundos sin configuración. Un administrador puede actualizar flow_builder_http_timeout_seconds mediante la actualización canónica de la cuenta (PATCH /api/v1/accounts/:id), con un entero de 1 a 120; null restaura el límite de 30. El campo timeout_seconds del nodo y de la prueba respeta ese límite. El contenido del nodo no puede elevar la autoridad de la cuenta.
Por encima de 30 segundos, el timeout cubre toda la operación HTTP, incluidas las páginas y la lectura de la respuesta. El lease del paso HTTP cubre ese presupuesto con margen. Los modos anteriores mantienen el timeout por página; los webhooks no cambian. El proveedor puede haber cobrado antes del timeout: use la salida de error para registrar una nota o transferir, sin repetir una consulta pagada antes de conciliarla. Los resultados ambiguos tras una interrupción del worker siguen requiriendo revisión manual.
La vista previa síncrona también respeta el plazo disponible de la solicitud web y reserva dos segundos para responder. Si el plazo solicitado no cabe, no se inicia ninguna solicitud externa y la vista previa explica el motivo. Esto no reduce el plazo del nodo en el worker. Toda la muestra paginada debe caber en esa ventana.