Documentación de Surtibot

Guía Maestra de Surtibot

Este documento es el recurso definitivo para cualquier usuario de Surtibot. Su propósito es guiarle en un viaje de descubrimiento y dominio, desde los conceptos más fundamentales hasta las estrategias de automatización más sofisticadas. Surtibot es una plataforma de automatización de marketing y comunicación omnicanal de vanguardia, diseñada para actuar como el centro neurálgico de todas las interacciones con sus clientes a través de WhatsApp, Facebook Messenger, Instagram, Telegram y su propio sitio web.

En el corazón de Surtibot reside una filosofía que combina la eficiencia de la automatización, el poder de la integración y la inteligencia de la colaboración entre humanos y IA.

Parte 1: Fundamentos de Surtibot

1.1 Vistazo General del Centro de Mando

Al iniciar sesión, accederá a su panel de control o Dashboard. Desde aquí, obtendrá una vista panorámica de toda su operación de comunicación. Las secciones clave son:

  • Connect Account: El punto de partida para vincular sus canales sociales y de mensajería.
  • Bot Manager: El corazón de la creación de bots, donde diseñará y gestionará todos sus flujos de conversación.
  • Subscriber Manager: Su CRM centralizado, donde residen y se gestionan todos los contactos.
  • Live Chat / Shared Inbox: La bandeja de entrada unificada para que sus agentes humanos gestionen conversaciones en tiempo real.
  • Broadcasting: La herramienta para enviar campañas de mensajes masivos a sus audiencias segmentadas.
  • Integrations: El centro de conexiones para vincular Surtibot con otras aplicaciones como WooCommerce, Shopify y Zapier.

1.2 Configuración Inicial de la Cuenta

Actualización de Información y Seguridad

Es vital mantener esta información precisa: actualice su nombre, foto de perfil, correo electrónico y número de móvil. Para una capa adicional de protección, es altamente recomendable habilitar la Autenticación de Dos Factores (2FA).

Preferencias Clave

  • Zona Horaria: Este es uno de los ajustes más críticos. Una configuración incorrecta aquí puede causar que las automatizaciones programadas se ejecuten en momentos incorrectos.
  • Configuración de Idioma: Personalice el idioma de la interfaz y configure un "Live Chat Translation Language" para las traducciones automáticas en el chat en vivo.
  • Firma del Agente: Establezca una firma predeterminada que sus agentes humanos utilizarán en el chat en vivo para asegurar consistencia y profesionalismo.

1.3 Conexión de Canales de Comunicación

Surtibot centraliza sus canales de mensajería. La conexión se realiza a través de las APIs oficiales de cada plataforma, lo que garantiza estabilidad y cumplimiento de las normativas.

API de WhatsApp Business

Requisito Crucial: Antes de empezar, asegúrese de tener una cuenta de Meta Business Manager verificada y un número de teléfono "limpio" que no esté actualmente en uso ni en la app personal de WhatsApp ni en la app WhatsApp Business.

El proceso de conexión se inicia desde el panel de Surtibot, haciendo clic en "Login with Facebook" y siguiendo las indicaciones de Meta.

Facebook Messenger e Instagram

La conexión de estos dos canales es un proceso unificado. Al iniciar sesión con Facebook y otorgar los permisos, Surtibot detectará y listará automáticamente todas sus Páginas de Facebook y cuentas de Instagram profesionales.

Telegram

La conexión con Telegram se basa en el sistema de bots de la propia plataforma. Busque a @BotFather en Telegram, cree un nuevo bot para obtener un token de API y péguelo en Surtibot.

Parte 2: Creación de Chatbots Inteligentes

2.1 Creador de Flujos Visual

Es la herramienta central de Surtibot, un entorno de "arrastrar y soltar" (drag-and-drop) para diseñar flujos de conversación complejos sin necesidad de programar.

Glosario de Componentes Principales

Componente Descripción
Start Bot Flow El punto de inicio de cada flujo. Aquí se definen el título y las palabras clave.
Text / Media Envía un mensaje de texto simple o contenido multimedia (imagen, video, etc.).
Input Flow / User Input Inicia una secuencia de preguntas para recopilar datos estructurados del usuario.
Conditional Reply Dirige la conversación por diferentes caminos basándose en una condición lógica.
HTTP API Realiza una llamada a una API externa para enviar o recibir datos en tiempo real.
AI Reply Invoca al Asistente de IA para generar una respuesta basada en el entrenamiento previo.

2.2 Anatomía de un Bot

Un disparador como Keywords (Palabras Clave) o un Botón de Acción inicia una Respuesta de Bot (Bot Reply), que es el flujo completo. En canales como Messenger, un Postback es un flujo reutilizable que se activa al hacer clic en un botón, haciendo el diseño más modular.

2.3 Captura de Datos para Conversión

Los Input Flows son secuencias de preguntas para recopilar datos. La información se guarda en Campos Personalizados (Custom Fields), que son variables como {{nombre_cliente}} que puede usar para personalizar cualquier mensaje futuro.

2.4 Lógica Conversacional Avanzada

La Respuesta Condicional (Conditional Reply) permite crear rutas de conversación dinámicas. El Menú Persistente y los Rompehielos (Icebreakers) son herramientas diseñadas para guiar al usuario y facilitar el inicio de la interacción.

Parte 3: Asistente de IA

3.1 Introducción al Asistente de IA

El Asistente de IA es una capa de inteligencia conversacional que permite al bot comprender la intención del usuario y responder a preguntas abiertas de una manera más natural y flexible.

3.2 Entrenamiento Personalizado

Debe entrenar a su IA con el conocimiento específico de su negocio. Puede alimentar su campaña con:

  • Preguntas Frecuentes (FAQs)
  • URLs (Surtibot "aprende" de su sitio web)
  • Archivos (PDF, DOC, TXT)

3.3 Detección de Intenciones

Permite al bot entender el propósito real de la solicitud de un usuario (la "intención") y tomar acciones específicas, como disparar un flujo de bot o asignar la conversación a un agente humano.

3.4 Implementación Práctica

La implementación más común es como respuesta de respaldo ("No Match Reply"). Edite el flujo "No Match" y arrastre el componente "AI Reply" para que la IA intervenga cuando no se reconozca ninguna palabra clave.

Parte 4: Gestión Omnicanal

4.1 Gestor de Suscriptores (CRM)

Es la base de datos central de cada persona que ha interactuado con sus bots. Es una herramienta proactiva para la segmentación y el marketing personalizado. Permite filtrar, etiquetar (con "Labels") y asignar acciones para crear campañas dirigidas.

4.2 Bandeja de Entrada Compartida

Centraliza en una única interfaz todas las conversaciones en tiempo real. Al seleccionar una conversación, se muestra un panel lateral con toda la información contextual del usuario, proporcionando al agente un conocimiento de 360 grados del cliente. Los agentes pueden colaborar con notas internas y transferir chats.

Parte 5: Marketing a Escala

5.1 Broadcasting en WhatsApp

Es la capacidad de enviar un único mensaje a una lista masiva de suscriptores.

Requisito Indispensable: Para enviar un mensaje promocional después de 24 horas, es obligatorio utilizar una Plantilla de Mensaje (Message Template) que haya sido previamente aprobada por Meta.

5.2 Campañas de Secuencia

Una campaña de secuencia (o drip campaign) es una serie de mensajes programados que se envían a intervalos definidos después de que un usuario realiza una acción específica. Son ideales para la nutrición de leads y el onboarding.

5.3 Notificaciones (RCN) en Messenger

Es la única metodología que cumple con las políticas de Meta para enviar mensajes promocionales en Messenger fuera de la ventana de 24 horas, y requiere un consentimiento explícito del usuario (opt-in).

Parte 6: Integraciones Avanzadas

6.1 E-commerce

Surtibot ofrece integraciones específicas para WooCommerce y Shopify para automatizar notificaciones de pedido, actualizaciones de envío y la recuperación de carritos abandonados.

6.2 Webhooks y API

El Webhook Workflow le proporciona una URL única para recibir notificaciones de sistemas externos. La integración de API HTTP le permite a su bot consultar o enviar datos a cualquier API externa en tiempo real.

6.3 Zapier

Zapier permite conectar Surtibot con más de 5,000 aplicaciones web (como Google Sheets, Slack, Trello, etc.) sin escribir una sola línea de código.

6.4 Email y SMS

Surtibot ofrece integraciones nativas con plataformas de email marketing como Mailchimp y con pasarelas de SMS como Twilio.

Parte 7: Administración y Soporte

7.1 Gestión Avanzada

Configure los Horarios Comerciales (Business Hours) para definir cuándo sus bots deben estar activos. También puede definir una Respuesta por Defecto (No Match Reply) global.

7.2 Troubleshooting

Error / Síntoma Causa Común Solución Clave
El bot no responde Webhook mal configurado en Meta. Verificar URL del webhook y suscripción al evento messages.
Respuestas duplicadas Dos webhooks activos. Asegurarse de que solo una fuente esté enviando eventos.
Hora incorrecta Zona horaria mal configurada. Ir a la configuración de la cuenta y seleccionar la "Timezone" correcta.

7.3 Soporte y Comunidad

Surtibot ofrece un ecosistema de soporte completo que incluye una Base de Conocimientos, Blog, Canal de YouTube, Chat en Vivo, Tickets de Soporte y un Foro de Discusión.