Saltar al contenido principal

Selección de Número de WhatsApp

info

Esta documentación explica cómo el sistema selecciona automáticamente qué instancia de WhatsApp usar al enviar mensajes salientes. Comprender este proceso te ayudará a optimizar tu configuración y solucionar problemas de mensajería.

Video de Descripción General​

Descripción General​

El sistema de Selección de Número de WhatsApp determina qué instancia y número de teléfono de WhatsApp usar al enviar mensajes salientes. Este sistema implementa un algoritmo de selección basado en prioridades con manejo integral de errores y mecanismos de respaldo.

Jerarquía de Prioridad de Selección​

El sistema sigue un orden de prioridad estricto para asegurar una selección de número predecible y lógica:

Prioridad 1: Anulación Manual (Más Alta)​

Patrón de Anulación Manual

Usa \{\{ WA#N \}\} en tu mensaje donde N es el índice de la instancia para forzar un número de instancia de WhatsApp específico.

Cuándo se Usa: Cuando un mensaje contiene un patrón de anulación manual

Ejemplo: "Este mensaje irá por la 2da instancia \{\{ WA#2 \}\}"

Comportamiento:

  • Extrae el índice de la instancia del patrón del mensaje
  • Valida que la instancia exista y esté conectada
  • Elimina el patrón del mensaje antes de enviar
aviso

El sistema arrojará un error si la instancia especificada no existe o no está conectada.

Prioridad 2: Etiquetas de Contacto​

Etiquetado de Contactos

Etiqueta contactos con wa: +1234567890 para usar siempre un número de WhatsApp específico para ese contacto.

Cuándo se Usa: Cuando un contacto tiene una etiqueta de número de WhatsApp

Ejemplo: Contacto etiquetado con wa: +15551234567

Comportamiento:

  • Busca en las etiquetas del contacto el patrón de número de WhatsApp
  • Encuentra la instancia con el número de teléfono coincidente
aviso

Ocurre un error si la instancia del número etiquetado no está conectada.

Prioridad 3: Contacto Asignado A​

Asignación de Usuario

Cuando un contacto está asignado a un usuario en tu CRM, el sistema intentará usar la instancia de WhatsApp de ese usuario para mensajería.

Cuándo se Usa: Cuando un contacto está asignado a un usuario específico que tiene una instancia de WhatsApp asignada

Comportamiento:

  • Busca el usuario asignado del contacto
  • Encuentra la instancia de WhatsApp asignada a ese usuario
aviso

Ocurre un error si la instancia del usuario asignado no está conectada.

Prioridad 4: Instancia Predeterminada​

Mejor Práctica

Siempre establece una instancia como "predeterminada" para cada ubicación para asegurar un comportamiento de respaldo confiable.

Cuándo se Usa: Cuando no se encuentra una asignación específica

Comportamiento:

  • Usa la instancia marcada como "predeterminada" para la ubicación
  • Solo considera instancias conectadas

Prioridad 5: Cualquier Instancia Disponible (Más Baja)​

Cuándo se Usa: Como último recurso

Comportamiento:

  • Selecciona cualquier instancia conectada con un número de teléfono
peligro

Si no hay instancias disponibles en este punto, el mensaje fallará con el Error 106.

Ejemplos de Configuración Avanzada​

Ejemplo 1: Configuración de Comercio Electrónico​

Instancia #1: +1-555-ORDERS (Confirmaciones de pedidos)
- Asignada a: Usuario de Gestión de Pedidos
- Uso: Flujos de trabajo de pedidos automatizados

Instancia #2: +1-555-SUPPORT (Predeterminada - Servicio al cliente)
- Marcada como: Instancia Predeterminada
- Uso: Consultas generales de clientes

Instancia #3: +1-555-BILLING (Consultas de facturación)
- Etiquetas de Contacto: Clientes VIP etiquetados con "wa: +1-555-BILLING"
- Uso: Comunicaciones de pago y facturación

Ejemplo 2: Gestión de Clientes de Agencia​

Instancia #1: Número de Marca del Cliente A
- Anulación Manual: Los flujos de trabajo usan `\{\{ WA#1 \}\}` para el Cliente A

Instancia #2: Número de Marca del Cliente B
- Asignación de Usuario: Miembros del equipo del Cliente B asignados a la Instancia #2

Instancia #3: Línea Principal de la Agencia (Predeterminada)
- Instancia Predeterminada: Usada para todas las otras comunicaciones

Mejores Prácticas​

Recomendaciones de Configuración​

  1. Siempre Establece una Predeterminada: Asegura que una instancia esté marcada como predeterminada para escenarios de respaldo
  2. Documenta tu Estrategia: Mantén un registro de qué números se usan para qué propósitos
  3. Prueba tu Configuración: Envía mensajes de prueba para verificar que la selección de número funcione como se espera
  4. Monitorea Regularmente: Revisa el estado de conexión de las instancias diariamente

Prevención de Errores​

  1. Valida Anulaciones Manuales: Asegura que los patrones \{\{ WA#N \}\} hagan referencia a instancias existentes y conectadas
  2. Mantén las Etiquetas de Contacto: Mantén las etiquetas wa: actualizadas cuando cambien las instancias
  3. Revisa las Asignaciones de Usuarios: Verifica regularmente que los usuarios asignados tengan instancias conectadas
  4. Monitoreo de Salud: Configura alertas para desconexiones de instancias

Flujo de Trabajo de Solución de Problemas​

  1. Revisa el Código de Error: Identifica el error específico (101-106)
  2. Verifica el Estado de la Instancia: Confirma qué instancias están conectadas
  3. Revisa la Configuración: Verifica asignaciones de usuarios, etiquetas y configuraciones predeterminadas
  4. Prueba la Resolución: Envía un mensaje de prueba para verificar que la solución funcionó
  5. Documenta Problemas: Mantén un registro de problemas comunes y soluciones

Documentación Relacionada​

Para soporte adicional con problemas de selección de número, contacta a nuestro equipo a través del botón de WhatsApp a continuación.

Let's connect