Centro de ayuda

Guía de implementación

Orden recomendado para poner en marcha una empresa nueva. Cada paso enlaza a su sección del manual.

1. 1
   Paso 1: Vincula tu número

   Crea una instancia por cada número de WhatsApp y vincúlala con el QR.

2. 2
   Paso 2: Crea una API key

   Una por sistema que se vaya a integrar, con los permisos mínimos y limitada a su instancia.

3. 3
   Paso 3: Configura un webhook

   Para que tu sistema reciba los mensajes entrantes y los estados; verifica la firma HMAC.

4. 4
   Paso 4: Configura la empresa

   Datos fiscales, zona horaria, moneda, logo y colores del CRM.

5. 5
   Paso 5: Da de alta usuarios y roles

   Revisa los roles de sistema, crea los propios si hace falta y da de alta a tu equipo.

6. 6
   Paso 6: Ajusta los campos

   Oculta los campos que no uses y agrega los propios de tu negocio.

7. 7
   Paso 7: Define tu pipeline

   Etapas de tu proceso de venta con su probabilidad.

8. 8
   Paso 8: Carga clientes y prospectos

   Importa tu cartera desde CSV y registra a los prospectos para darles seguimiento.

Módulos

Primeros pasos

• Inicio del panel

  La primera pantalla al entrar: tu plan, los mensajes enviados hoy contra el límite diario, las instancias usadas y el estado de cada número.

WhatsApp

• Instancias

  Conecta tus números de WhatsApp: cada instancia es un número vinculado por código QR que envía y recibe mensajes para tu cuenta.

• Mensajes

  Historial de los mensajes enviados y recibidos por tus instancias: filtra, revisa el estado de entrega, el motivo de un fallo y descarga los archivos recibidos.

Integración

• API keys

  Llaves para que tus sistemas (ERP, tienda en línea, CRM propio) usen la API: define permisos, limítalas a una instancia, ponles vencimiento y revócalas cuando ya no se usen.

• Webhooks

  Recibe en tu sistema, en tiempo real, los mensajes entrantes y los cambios de estado de mensajes e instancias, con firma HMAC para verificar que vienen de Chat Digital.

• Integración (API REST)

  Cómo enviar mensajes de WhatsApp desde tus sistemas con la API REST: ejemplos con curl y Node.js, Idempotency-Key, queueIfOffline, estados y errores comunes.

CRM

• Tablero de oportunidades

  Tablero Kanban con las oportunidades de venta por etapa: arrástralas para avanzarlas, registra por qué se perdieron y revisa montos, vendedores y fechas de cierre.

• Clientes

  Personas y empresas con las que trabajas: alta con formulario configurable, filtros, etiquetas, importación y exportación CSV y la vista Cliente 360 con contactos, oportunidades y actividad.

• Prospectos

  Personas interesadas que aún no son clientes: califícalas con temperatura y puntuación, agenda la próxima acción, descártalas con motivo o conviértelas en cliente con o sin oportunidad.

Configuración CRM

• Empresa

  Datos fiscales y de contacto de tu empresa, zona horaria, moneda, idioma y la identidad visual (logo y colores) del CRM.

• Usuarios

  Las personas con acceso al panel y al CRM (mismo inicio de sesión): alta, roles, sucursal, estado y bloqueo.

• Roles y permisos

  Define qué puede hacer cada persona en el CRM: roles de sistema listos para usar, roles propios y el catálogo de permisos por módulo.

• Sucursales

  Ubicaciones de tu empresa, con contacto y zona horaria propia; los equipos y usuarios se asignan a una sucursal.

• Equipos

  Grupos de trabajo con un líder, dentro de una sucursal: crea equipos y administra sus miembros.

• Campos personalizados

  Decide qué datos se capturan de clientes, contactos, prospectos y oportunidades: agrega campos propios, renombra u oculta los de sistema, márcalos obligatorios, como columna o filtrables y ordénalos.

• Etiquetas y orígenes

  Etiquetas de colores para clasificar clientes y prospectos, y orígenes para saber de dónde llegan.

• Pipelines

  Embudos de venta del tablero y sus etapas: tipos En curso, Ganada y Perdida, probabilidad, colores, orden y pipeline por omisión.

• Auditoría

  Registro de quién cambió qué y cuándo en la configuración del CRM, con el antes y el después de cada cambio.

Cuenta

• Mi cuenta y seguridad

  Cambia tu contraseña, verifica tu email, recupera el acceso si la olvidaste y cierra las sesiones abiertas en otros dispositivos.

Preguntas frecuentes

Glosario

API key

Llave secreta con la que un sistema se identifica ante la API (header X-API-Key). Tiene permisos (scopes), puede limitarse a una instancia y se muestra una sola vez. Ver módulo

Auditoría

Registro de quién cambió qué y cuándo en la configuración del CRM. Ver módulo

Campo personalizado

Dato adicional que tu empresa agrega a clientes, contactos, prospectos u oportunidades (p. ej. «Fecha de aniversario»). Se configura en Campos personalizados. Ver módulo

chatId

Identificador de un chat de WhatsApp: el número con código de país seguido de @c.us (personas) o un id terminado en @g.us (grupos). Ver módulo

Contacto

Persona de un cliente empresa (comprador, gerente…). Uno de ellos es el contacto principal. Ver módulo

Etapa

Paso de un pipeline (p. ej. «Cotización enviada»). Puede ser En curso, Ganada o Perdida y tiene una probabilidad. Ver módulo

Etiqueta

Marca de color para clasificar clientes y prospectos (VIP, Mayoreo…) y filtrar por ella. Ver módulo

Firma HMAC

Código que acompaña cada webhook (X-WhatsA-Signature) calculado con tu secreto. Tu sistema lo recalcula para comprobar que el evento viene de Chat Digital y no fue alterado. Ver módulo

Idempotencia

Propiedad de una operación que, repetida, da el mismo resultado. Con Idempotency-Key un reintento no duplica el mensaje; en webhooks, significa ignorar eventos que ya procesaste. Ver módulo

Instancia

Conexión de un número de WhatsApp con la plataforma, vinculada por código QR. Ver módulo

LID

Identificador interno que WhatsApp usa cada vez más en lugar del número (termina en @lid). Chat Digital lo traduce al número real (…@c.us) cuando WhatsApp lo permite; si no, verás el LID en el chat. Ver módulo

Oportunidad

Venta posible con un cliente o prospecto, con monto, vendedor, fecha estimada de cierre y etapa del pipeline. Ver módulo

Origen

De dónde llegó un cliente o prospecto (Expo, Facebook, Recomendación…). Ver módulo

Permiso

Acción concreta que un rol permite, p. ej. clientes.editar. Los permisos de un usuario son la suma de sus roles. Ver módulo

Pipeline

Embudo de ventas: la secuencia de etapas por las que pasa una oportunidad. Se ve como columnas en el tablero. Ver módulo

Prospecto

Persona interesada que aún no es cliente. Se califica con puntuación y temperatura y se convierte en cliente o se descarta. Ver módulo

Referencia

Identificador propio de tu sistema (p. ej. número de pedido) que mandas al enviar un mensaje; sirve para buscarlo y viaja en los webhooks. Ver módulo

Rol

Conjunto de permisos que se asigna a los usuarios (Administrador, Vendedor…). Ver módulo

Scope

Permiso de una API key: instances.read, messages.send o messages.read. Ver módulo

Tenant

La cuenta de una empresa en la plataforma, con su plan, instancias, usuarios y CRM separados de las demás.

Webhook

URL de tu sistema a la que Chat Digital envía un POST cada vez que ocurre un evento (mensaje recibido, cambio de estado…). Ver módulo