1) Qué es Alfa Business CRM AI

2) Acceso rápido y rutas públicas

3) Checklist de instalación y puesta en marcha (de 0 a operativo)

1. Acceso y perfil
   • Entra en /login y completa tu perfil (nombre, idioma, zona horaria).
   • Revisa tus permisos asignados (rol usuario/agent). Pide a tu admin que te agregue a las colas donde atenderás.
   • Activa notificaciones si tu navegador lo permite para no perder tickets.
2. Lo mínimo para que el CRM “funcione” (30–45 min)
   • 1) Conectar un canal (para que entren mensajes): ve a /connections y conecta WhatsApp (QR) o el canal que uses.
   • 2) Crear una cola (para organizar): ve a /queues y crea “Ventas” o “Soporte”.
   • 3) Asignarte a la cola: si tienes permisos, agrega tu usuario a esa cola (si no, pídelo a un admin).
   • 4) Probar: envía un “Hola” desde tu móvil → abre /tickets y confirma que se creó el ticket.
   • 5) Responder y cerrar: responde, agrega una nota, mueve Kanban si aplica y cierra con motivo.
3. Empresa y branding
   • Ve a /settings: datos de empresa, idioma y configuraciones.
   • Verifica límites de plan y facturación (suscripciones/invoices) si los ves habilitados.
4. Usuarios y roles
   • Usuarios (si tienes permisos): https://hub.alfabusiness.app/users
   • Configura admins y agentes. Asigna colas y permisos por módulo (tickets, campañas, bots, archivos).
   • Tip: crea al menos 1 admin y 2 agentes para pruebas y cobertura.
   • Define quién puede crear campañas/bots y quién solo atiende tickets.
5. Conectar canales (después de instalar)
   • URL: https://hub.alfabusiness.app/connections
   • Conecta el canal y prueba con un mensaje real (debe crear ticket).
   • Para el paso a paso por canal (WhatsApp, IF, FB, Telegram, WebChat): ve a Integraciones paso a paso.
6. Colas y router
   • URL: https://hub.alfabusiness.app/queues
   • Crea colas por área (Ventas, Soporte, Cobranza).
   • Define router (round-robin/aleatorio) y horarios; agrega mensaje de bienvenida y fuera de horario.
   • Asigna agentes a cada cola y activa notificaciones.
   • Prueba: envía un mensaje al canal y confirma que se enruta a la cola correcta.
7. Tickets y Kanban
   • Tickets: /tickets · Kanban: /kanban
   • Diseña etapas Kanban (Lead, En progreso, Cotización, Cierre, Postventa).
   • Configura motivos de cierre y notas obligatorias si aplica.
   • Prueba crear un ticket desde un mensaje entrante y muévelo en el tablero.
   • Registra al menos 2 motivos de cierre (ej. “Sin contacto”, “Cerrado con venta”).
8. Contactos y listas
   • Contactos: /contacts · Importar: /contacts/import
   • Importa contactos o créalos manualmente. Valida números al guardarlos.
   • Crea listas/segmentos con etiquetas (ej. “clientes-activos”, “leads-nuevos”).
   • Guarda campos clave: nombre, teléfono, email, origen, tags, o campos personalizados.
9. Campañas y mensajes programados
   • Campañas: /campaigns · Programados: /schedules
   • Lanza 1 campaña de reactivación y 1 de postventa usando listas de clientes o etiquetas.
   • Programa recordatorios (+24h, +72h, cobro, cita) para hacer seguimiento.
   • Incluye enlace o archivo cuando aplique; revisa previsualización antes de enviar.
10. Bots, IA y Flow Builder
    • Flow Builder: /flowbuilders
    • Elige un flujo base (flow default), ajusta nodos y condiciones.
    • Define prompts IA para precalificar: 5–7 preguntas, políticas de qué responder y cuándo transferir.
    • Activa derivación a humano en horario laboral y captura datos fuera de horario.
    • Prueba el flujo contigo mismo antes de publicarlo a clientes.
11. Webhooks y API
    • Activa webhooks salientes (tickets, mensajes, contactos) hacia tu endpoint o N8N.
    • Verifica que tu endpoint responda 2xx; maneja reintentos en N8N o servidor propio.
12. Monitoreo rápido
    • Dashboard: /dashboard · Reportes: /reports
    • Dashboard y estadísticas por colas/agentes.
    • Diagnóstico de WhatsApp: revisa estados y, si es necesario, reescanea o actualiza credenciales.
    • Revisa métricas diarias: tickets abiertos/cerrados, TMO, SLA de respuesta.

4) Conceptos básicos (para entender el CRM rápido)

5) Guía por roles (qué hace cada uno)

6) Guía por pantallas (URLs directas + pasos cortos)

Inbox / Tickets — https://hub.alfabusiness.app/tickets

1. Entrar: abre /tickets.
2. Priorizar: empieza por “Sin asignar” → luego “Pendientes” → luego “Hoy”.
3. Abrir ticket: selecciona un ticket y revisa el historial, tags y responsable.
4. Responder: escribe un mensaje claro, adjunta archivos si aplica y confirma recepción.
5. Ordenar: agrega tags (ej. “lead-caliente”, “soporte”) y una nota interna con acuerdos.
6. Escalar o reasignar: si no es tu área, transfiérelo a la cola correcta.
7. Cerrar: finaliza con motivo (para que los reportes sirvan).

Tips

• Usa el historial para no preguntar dos veces lo mismo.
• Siempre deja una nota interna al cerrar o transferir.

Problemas típicos

• No aparece el ticket: revisa conexión del canal y colas.
• No puedes responder: revisa permisos o si el ticket está cerrado.

Kanban — https://hub.alfabusiness.app/kanban

1. Entrar: abre /kanban.
2. Visualizar: cada columna representa una etapa (Lead, En progreso, Cierre, etc.).
3. Mover: arrastra el ticket a la etapa correcta después de cada interacción.
4. Cerrar con orden: cuando la venta/soporte termina, pasa a “Cerrado” y registra motivo.

Importante

• Las “columnas” del Kanban se configuran con Etiquetas Kanban (ver la pantalla /TagsKanban).
• Los motivos de finalización aparecen al cerrar el ticket y se administran por el admin de tu empresa (ver sección “Motivos de finalización”).

Etiquetas Kanban (columnas) — https://hub.alfabusiness.app/TagsKanban

Para qué sirve

• Define las etapas del tablero Kanban (Lead, En progreso, Cotización, Cierre, Postventa).
• Hace que el equipo trabaje igual: misma etapa = mismo significado.
• Mejora reportes: puedes medir cuánto tiempo pasan los tickets en cada etapa.

1. Entrar: abre /TagsKanban.
2. Crear etapa: presiona “Nueva etiqueta/etapa” (o “Add”) y define:
   • Nombre: ej. “Lead”, “En progreso”, “Cotización”, “Cierre”, “Postventa”.
   • Color: elige un color distinto por etapa para lectura rápida.
   • Orden: define el orden de izquierda a derecha.
3. Elegir etapa por defecto: marca una etapa como “Default” (por ejemplo “Lead”) para que los tickets nuevos caigan ahí.
4. Configurar “siguiente etapa” (si está disponible): define a qué etapa pasa cuando el agente finaliza la acción (ej. “Lead” → “En progreso”).
5. Mensaje por etapa (si aplica): algunas configuraciones permiten un mensaje al entrar a una etapa (ej. “Cotización enviada, ¿te sirve si coordinamos una llamada?”).
6. Prueba:
   • Ve a /kanban y confirma que aparecen las columnas.
   • Abre un ticket en /tickets y muévelo en Kanban.

Recomendación de etapas (simple y efectiva)

• Lead → En progreso → Cotización → Cierre → Postventa
• Si haces soporte: Nuevo → Diagnosticando → En proceso → Resuelto

Conexiones / Canales — https://hub.alfabusiness.app/connections

Qué es y por qué importa

• Aquí conectas los canales por donde llegan los mensajes (y desde donde se envían campañas y automatizaciones).
• Cuando un canal está bien conectado, el resultado siempre es el mismo: mensaje real → ticket → cola/asignación → respuesta → cierre con motivo.

Canales típicos

• WhatsApp: QR (rápido) y/o WhatsApp Business API oficial (Meta Cloud API).
• Meta: Facebook/Instagram (mensajes) vía webhooks.
• Telegram, LINE, WebChat, Email, Twilio (SMS/Voz).

1. Entrar: abre /connections.
2. Crear conexión: elige el canal y completa los datos que pida el formulario (QR, token, credenciales o webhook).
3. WhatsApp oficial: se configura primero en Meta. Referencias:
   • Cloud API · Get Started
   • Cloud API · Webhooks
   • Plantillas: Message Templates
4. Probar: envía un mensaje real y valida que aparezca en /tickets.
5. Guía completa: si quieres el paso a paso por canal, ve a Integraciones paso a paso.

Checklist rápido de verificación

• ¿El canal aparece como conectado/activo?
• ¿Llega un ticket nuevo a /tickets?
• ¿Se asigna a la cola correcta (o puedes transferirlo)?
• ¿Puedes responder y cerrar con motivo?

Colas — https://hub.alfabusiness.app/queues

1. Entrar: abre /queues.
2. Para qué sirven: una cola es un “departamento” (Ventas/Soporte/Cobranza) que determina quién ve los tickets, cómo se asignan y qué mensajes automáticos se envían.
3. Crear: crea al menos 1 cola (ej. “Ventas”). Ideal: 3 colas (Ventas/Soporte/Cobranza) para ordenar operación.
4. Asignarte a una cola (por qué importa):
   • Si no estás asignado a una cola, normalmente no verás los tickets de esa cola o no te los asignará el router.
   • La asignación define tu “bandeja real” y afecta el reparto automático.
5. Router (asignación automática):
   • Round-robin: reparte de forma pareja entre agentes de la cola.
   • Aleatorio: asigna al azar entre agentes disponibles.
   • Recomendación: Ventas → round-robin; Soporte → round-robin; Cobranza → según estrategia.
6. Horarios:
   • Define cuándo estás “abierto” y cuándo aplica fuera de horario.
   • Combina con bot/flow fuera de horario para capturar datos sin perder leads.
7. Mensajes automáticos:
   • Bienvenida: primer mensaje al entrar a la cola (expectativas + próxima acción).
   • Fuera de horario: pide nombre/motivo y promete respuesta al abrir.
8. Configurar SLA: define objetivos por cola (ej. primera respuesta < 5 min en Ventas) para que reportes tengan sentido.
9. Prueba: envía un mensaje por el canal conectado → abre /tickets → valida cola, asignación y tiempos.

Buenas prácticas recomendadas

• Una cola por intención: Ventas (conversión), Soporte (incidencias), Cobranza (pagos).
• Evita “todo en una cola”: te rompe los reportes y el control de SLA.
• Si un ticket entra “mal”, transfiérelo a la cola correcta y deja nota interna.

Contactos — https://hub.alfabusiness.app/contacts

1. Entrar: abre /contacts.
2. Crear: agrega nombre + número (con prefijo) + tags.
3. Buscar: filtra por nombre, número o tags.
4. Bloquear/desbloquear: si aplica para spam o casos especiales.

Importación

• Importar: /contacts/import
• Recomendación: importa con tags para segmentación inmediata (campañas/bots).

Campañas — https://hub.alfabusiness.app/campaigns

1. Entrar: abre /campaigns.
2. Segmentar: define audiencia por lista/tags (ej. “leads-nuevos”).
3. Contenido: mensaje corto + CTA claro (“Responde 1/2/3”).
4. Ventana horaria: evita enviar fuera de horario del público.
5. Medir: revisa respuestas y convierte a ticket/etapa Kanban.

Programados / Agenda — https://hub.alfabusiness.app/schedules

1. Entrar: abre /schedules.
2. Crear: define contacto, fecha/hora y mensaje.
3. Operación: úsalo para +24h/+72h, cita, pago, postventa.
4. Buenas prácticas: escribe mensajes cortos y con contexto del caso.

Automatización / Flow Builder — https://hub.alfabusiness.app/flowbuilders

1. Entrar: abre /flowbuilders.
2. Empezar simple: 3 nodos: saludo → 3 preguntas → derivación a cola.
3. Validar: define fallback (“no entendí, ¿puedes repetir?”) y transferencia a humano.
4. Escalar: agrega webhooks para disparar N8N o tu backend.

Reportes y dashboard — /reports · /dashboard

• Dashboard: /dashboard
• Reportes: /reports
• Objetivo: medir SLA, tickets activos, conversiones y tiempos de respuesta.

Chat interno — https://hub.alfabusiness.app/chats

1. Entrar: abre /chats.
2. Usar: coordina con el equipo sin salir del CRM y comparte archivos del caso.

Archivos — https://hub.alfabusiness.app/files

• Entrar: /files
• Buenas prácticas: nombre con contexto (cliente-fecha-caso) para búsquedas rápidas.

Configuración — https://hub.alfabusiness.app/settings

• Entrar: /settings
• Si tienes permisos: empresa, idioma, integraciones y parámetros operativos.

7) Mapa de módulos (qué resuelve cada uno)

8) Casos de uso (por área y por nicho)

1) Inmobiliarias (ventas de propiedades)

Cómo se usa

• Leads entran por WhatsApp/IG → se crean tickets y se etiquetan por zona/presupuesto.
• Kanban por etapas: Lead → Visita → Propuesta → Cierre → Postventa.
• Programados: recordatorio de visita, seguimiento 24/72h, documentación.

Beneficio

• Menos leads perdidos; respuesta más rápida y trazabilidad por asesor.
• Pipeline claro (qué se está negociando) y forecast más real.

2) Concesionarias / Automotriz

Cómo se usa

• Campañas por modelo y tags (nuevo/usado/financiación).
• Playbook: calificar (presupuesto, pago inicial, urgencia) y agendar test drive.
• Plantillas para cotización y envío de ficha técnica.

Beneficio

• Más agendamientos (test drive) y mejor conversión por seguimiento sistemático.
• Mejor control de tiempos de respuesta por agente/cola.

3) Clínicas, salud y estética

Cómo se usa

• Entradas por WhatsApp/WebChat → calificación (motivo, disponibilidad, sede).
• Programados: confirmación de cita, recordatorio 24h, reactivación post-servicio.
• Etiquetas por servicio para campañas segmentadas.

Beneficio

• Más asistencia a citas (menos no-show) y mejor retención/postventa.
• Atención ordenada por cola/sede con métricas reales.

4) Educación (institutos, cursos, academias)

Cómo se usa

• Leads por campaña → calificación (curso, horario, modalidad, presupuesto).
• Kanban: Lead → Contactado → Info enviada → Inscripción → Pago → Inicio.
• Bot responde FAQs y deriva a Ventas.

Beneficio

• Sube conversión de leads con respuesta rápida + seguimiento.
• Control de pipeline por curso/cohorte.

5) E-commerce / Retail

Cómo se usa

• Ventas: asesoría de compra (stock, envío) desde tickets.
• Postventa: devoluciones, garantías y reclamos en otra cola.
• Campañas: reactivación y recompra por tags.

Beneficio

• Más conversiones por chat y mejor experiencia (venta + soporte sin caos).
• Segmentación real para campañas (compró/no compró/interés).

6) Servicios profesionales (abogados, consultores, B2B)

Cómo se usa

• Calificación por tipo de caso/tamaño; adjunta archivos al ticket.
• Kanban: Lead → Diagnóstico → Propuesta → Negociación → Cierre.
• Email (Gmail) para centralizar correos ligados al ticket (si aplica).

Beneficio

• Proceso comercial trazable con “siguiente paso” siempre definido.
• Menos pérdida de contexto (archivos/correos/notas en un solo lugar).

9) Operación diaria (modo agente)

10) Rutinas recomendadas (diaria / semanal)

11) Playbooks (guías operativas por caso)

Playbook Ventas (de lead a cierre)

1. Primer mensaje (≤ 5 min): saluda, confirma nombre y motivo. Si viene de campaña, referencia el CTA.
2. Calificar: necesidad, presupuesto, urgencia, zona, decisión (5–7 preguntas máximo).
3. Propuesta: envía resumen + próximos pasos. Adjunta archivo si aplica.
4. Seguimiento: programa recordatorio +24h y +72h si no responde.
5. Cierre: mueve Kanban a “Cierre” y registra motivo (“Cerrado con venta” o “Sin contacto”).

Playbook Soporte (incidencias)

1. Diagnóstico: reproduce, solicita evidencia (captura/audio) y etiqueta el ticket.
2. Prioridad: define severidad y SLA; asigna a cola correcta.
3. Resolución: documenta pasos en notas; confirma con el cliente.
4. Cierre: motivo + aprendizaje (si fue recurrente, crea plantilla o mejora el bot).

Playbook Cobranza (recordatorios y acuerdos)

1. Recordatorio amable: fecha, monto, link/medio de pago.
2. Segundo intento: si no responde en 24h, mensaje más directo + opciones (acuerdo/fecha).
3. Acuerdo: registra en nota (fecha/medio) y programa recordatorio.
4. Cierre: pagado → motivo “Pagado”; no pagado → “Sin respuesta” o el que aplique.

12) Plantillas listas para usar (copiar/pegar)

13) Automatización, bots e IA

14) Integraciones paso a paso

WhatsApp (QR) — Baileys / WhatsApp Web JS

Qué configura

• Conexiones con canal whatsapp o whatsapp-web-js, y proveedor baileys o whatsapp-web-js.
• La sesión genera un QR y queda en estado CONNECTED cuando sincroniza.

1. Crear conexión: en el CRM crea una conexión WhatsApp (elige proveedor baileys o whatsapp-web-js).
2. Generar QR: abre la conexión y genera QR (si la UI no lo muestra, normalmente es porque falta sesión o permisos).
3. Escanear: en el teléfono → WhatsApp → Dispositivos vinculados → escanea el QR.
4. Validar: envía “Hola” al número → debe crear ticket en /tickets.
5. Si se cae: reinicia la sesión y reescanea (ver endpoint /whatsapp-restart/).

WhatsApp Business API oficial (Meta Cloud API) — canal whatsapp_oficial

Cómo funciona aquí

• Al crear la conexión oficial, el backend registra/crea la conexión y devuelve un webhook asociado (guardado como waba_webhook).
• Ese webhook es el que debes colocar en Meta Cloud API para recibir eventos.

Endpoints reales (backend)

• Crear conexión: POST /whatsapp/ con channel=whatsapp_oficial y campos waba_id, phone_number_id, send_token, etc.
• Sincronizar plantillas: GET /whatsapp/sync-templates/:whatsappId
• API de envío (token del canal): POST /api/messages/send · POST /api/messages/send/linkImage · POST /api/messages/checkNumber

1. En Meta: crea tu app + activa WhatsApp Cloud API: Get Started.
2. En el CRM: crea la conexión con canal whatsapp_oficial y completa credenciales (waba_id, phone_number_id, send_token, etc.).
3. Tomar el webhook: al guardar, el sistema asigna/guarda el webhook (ver campo waba_webhook en la configuración).
4. En Meta Webhooks: configura el callback con ese webhook (y completa la verificación según te pida Meta).
5. Probar envío: usa el token del canal para enviar con POST /api/messages/send y valida recepción/ticket.

Facebook / Instagram (Meta)

1. Conecta Facebook y/o Instagram en el botón y completa el flujo para dar permisos
2. Suscribe el objeto/página que corresponda (FB/IG messaging).
3. Prueba: envía un DM y valida que se cree ticket en Inbox.

WebChat (widget en tu web)

1. Crea el widget: en el panel crea un WebChat (POST /webchat).
2. Obtén el código: usa GET /webchat/:id/code y pégalo en tu sitio.
3. Probar: abre tu web → envía un mensaje → debe crear ticket.
4. Rotar token si lo necesitas: POST /webchat/:id/regenerate.

Telegram

1. BotFather: crea bot y copia token.
2. CRM: crea conexión Telegram y pega token.
3. Probar: envía un mensaje al bot y valida ticket.

Twilio (SMS / Voice)

Endpoints reales (backend)

• Config: GET/POST /twilio/config · POST /twilio/config/test
• Números: GET/POST /twilio/phone-numbers · PUT/DELETE /twilio/phone-numbers/:id
• SMS: POST /twilio/sms/send
• Llamadas: POST /twilio/calls · GET /twilio/calls
• Webhooks públicos: POST /twilio/voice/outgoing · POST /twilio/voice/status

1. CRM: guarda credenciales en /twilio/config y prueba conexión.
2. Twilio Console: configura Voice webhooks apuntando a /twilio/voice/outgoing y /twilio/voice/status.
3. Probar: envía SMS o realiza llamada y valida logs en el panel.

WaVoIP (llamadas WhatsApp)

1. Configura credenciales en el módulo.
2. Expón el webhook público y valida verificación.
3. Probar llamada y revisar historial/estadísticas.

15) Reportes y monitoreo

Dashboard y estadísticas

• Métricas por tickets, colas, agentes y tiempos de respuesta.
• Filtra por periodo y exporta si está habilitado.
• KPIs sugeridos: SLA < 5 min (ventas), cierre con venta, reactivación, N recontactos.

16) Motivos de finalización (cierre de tickets)

Para qué sirven

• Cuando cierras un ticket, elegir un motivo hace que los reportes sean reales: ventas cerradas, sin contacto, soporte resuelto, etc.
• Evita cierres “sin información” y mejora coaching del equipo.

Cómo lo vive un agente

• En /tickets al cerrar un ticket, el CRM te pedirá un motivo (si está habilitado) y, a veces, una nota.
• Regla práctica: si transfieres o cierras, deja nota interna con el acuerdo o siguiente paso.

Configurar motivos (admin de empresa)

1. Entrar a configuración: abre /settings.
2. Buscar sección: “Motivos de finalización / Motivos de cierre / Finalización”.
3. Crear al menos 4 motivos (recomendado):
   • Cerrado con venta
   • Sin contacto
   • No interesado
   • Soporte resuelto
4. Notas obligatorias (si tu empresa lo usa): habilita “nota obligatoria al cerrar” para asegurar contexto.
5. Prueba: cierra un ticket en /tickets y verifica que aparece el selector.

17) API y webhooks (uso rápido y correcto)

API “mensajería” (token por WhatsApp)

• Base: https://back-hub.alfabusiness.app/api/messages
• Requiere token del canal WhatsApp en Authorization: Bearer <WHATSAPP_TOKEN> (lo ves en la configuración de tu conexión WhatsApp).
• Enviar mensaje: POST /api/messages/send (soporta medias por multipart/form-data).
• Enviar link imagen: POST /api/messages/send/linkImage
• Validar número: POST /api/messages/checkNumber

18) Integración con N8N

Recibir eventos

• Crea webhook saliente en el CRM → apunta a nodo Webhook en N8N.
• Mapea JSON (ticket/contacto/mensaje) y continúa el flujo.
• Docs oficiales n8n: https://docs.n8n.io/ (busca “Webhook node”).

Enviar acciones

• Nodo HTTP Request → POST/GET a https://back-hub.alfabusiness.app/api (usa Swagger solo como referencia/documentación).
• Headers: Authorization: Bearer <token>, Content-Type: application/json.
• Docs oficiales n8n: https://docs.n8n.io/ (busca “HTTP Request node”).

Buenas prácticas

• Reintentos (429/5xx), manejo de timeouts y logs.
• Separar credenciales en N8N (variables/cred store).
• Normaliza errores y notifica por Slack/Email si un flujo falla.

Ideas

• E-commerce: pedido → N8N → API CRM envía “despachado”.
• Educación: formulario → crea contacto + ticket y asigna cola.
• Cobranza: vencimiento → mensaje programado + ticket.
• Postventa: entrega → encuesta NPS → ticket si NPS < 7.

19) Seguridad y operación

Autenticación y permisos

• Roles por módulo; solicita acceso a las colas donde trabajas.
• Idioma y configuración dependen de lo habilitado por el administrador de tu empresa.
• No compartas tokens ni API keys; rota claves periódicamente.

Privacidad y legales

• Páginas legales: /terminos, /privacidad, /eliminacion-de-datos.
• HTML sin caché (headers en server.js).

Observabilidad

• Salud en https://back-hub.alfabusiness.app/health y https://back-hub.alfabusiness.app/ping.
• Revisa diagnósticos/logs cuando un canal falle.

20) Soporte rápido

WhatsApp

• QR: reescanea si expira. Business API: revisa credenciales y webhooks en Meta (Get Started y Webhooks).
• Revisa diagnósticos y colas/horarios para evitar bloqueos.

Campañas y envíos

• Comprueba que el canal esté habilitado y plantillas listas.
• Si no se dispara, revisa jobs/cron y límites de plan.

21) FAQ (preguntas frecuentes)

No me llegan mensajes / no se crean tickets

• Verifica que el canal esté conectado y activo (WhatsApp/IG/FB/Telegram/WebChat/Email).
• Comprueba colas y horarios: si fuera de horario, revisa el mensaje automático/bot.
• Si es WhatsApp QR: reescanea. Si es Business API: valida credenciales y webhooks en Meta (Get Started y Webhooks).

Mis campañas no envían / envían poco

• Confirma que la lista tenga contactos y números válidos.
• Revisa límites del plan y plantillas (si aplica).
• Verifica ventanas horarias y que el canal de salida esté habilitado.

¿Qué token uso en la API?

• Usuario/panel: /auth/login (Bearer) para endpoints del panel (internos).
• WhatsApp token: para /api/messages/* (envío directo con token del canal).
• COMPANY_TOKEN: para /api/companies, /api/contacts, /api/plans, etc.

22) Glosario

Ticket

• Caso operativo (conversación + responsable + estado + historial).
• Lo que se reporta/gestiona; no solo “mensajes sueltos”.

Cola

• Área de atención (Ventas/Soporte/Cobranza).
• Define horarios, mensajes automáticos y router.

Router

• Regla que asigna tickets a agentes (round-robin/aleatorio, según configuración).
• Reduce tiempo de primera respuesta.

Kanban

• Tablero por etapas. Úsalo para pipeline comercial/soporte.
• Regla: mover ticket después de cada interacción importante.

Tag (Etiqueta)

• Segmentación operativa (ej. “lead-caliente”, “postventa”).
• Úsala para campañas, bots y reportes.

Campaña

• Envío masivo a una audiencia (lista/tags).
• Objetivo: generar conversaciones que se conviertan en tickets.

Programado

• Recordatorio uno-a-uno con fecha/hora (seguimientos, citas, cobros).
• Clave para no “perder” leads.

Flow / Bot

• Automatiza preguntas, calificación y derivación a humano/cola.
• Puede integrarse con N8N o webhooks.

23) URLs rápidas

• https://hub.alfabusiness.app/login: acceso al CRM.
• /documentacion y /beneficios: guías públicas.
• https://back-hub.alfabusiness.app/swagger: Swagger del backend (documentación de endpoints).
• /terminos · /privacidad · /eliminacion-de-datos.
• https://back-hub.alfabusiness.app/health y https://back-hub.alfabusiness.app/ping para estado.

Esta guía está pensada para la puesta en marcha y uso del CRM. Entra a /login, sigue el checklist y usa Swagger para explorar la API del backend. Para soporte, revisa diagnósticos y contacta a tu admin si necesitas más permisos.