Saltar al contenido principal
La selección de número funciona igual para todos los canales. Cuando envías un mensaje saliente, la integración recorre una jerarquía de prioridades fija y elige la primera instancia que coincide. Solo cambia la sintaxis de etiquetas y anulaciones entre WhatsApp, iMessage y SMS - la lógica de decisión no.

Jerarquía de Prioridad de Selección

El sistema evalúa estas reglas en orden y usa la primera que resuelva a una instancia conectada:
PrioridadReglaCómo se activa
1 (la más alta)Anulación ManualEl mensaje contiene un patrón de anulación (ej. { WA#N }, {IM#N})
2Cambio TemporalEl mensaje contiene un patrón de cambio temporal (ej. {TEMP-IM#N}) - solo ese mensaje
3Etiquetas de ContactoEl contacto está etiquetado con un número (ej. wa:, im:, sms:)
4Asignación de UsuarioEl contacto está asignado a un usuario que tiene una instancia asignada
5Instancia PredeterminadaHay una instancia predeterminada configurada para la ubicación
6 (la más baja)Cualquiera DisponibleRecurre a cualquier instancia conectada
En todos los casos el sistema solo considera instancias conectadas. Si la regla resuelve a una instancia desconectada, genera un error en lugar de continuar en silencio - consulta Errores de Selección de Número.

Referencia de Sintaxis por Canal

Los patrones siguientes son intercambiables en concepto - elige la fila del canal con el que estás enviando. N es el índice de la instancia; +1234567890 es el número de destino.
CapacidadWhatsAppiMessageSMS
Anulación manual{ WA#N }{IM#N}-
Cambio temporal (un mensaje)-{TEMP-IM#N}-
Etiqueta de contactowa: +1234567890im: +1234567890sms: +1234567890
Los patrones de anulación y cambio temporal se eliminan del cuerpo del mensaje antes de enviarlo, por lo que el destinatario nunca los ve.

Reglas de Prioridad en Detalle

1. Anulación Manual

Agrega el patrón de anulación de tu canal en cualquier parte del mensaje - { WA#N } para WhatsApp o {IM#N} para iMessage - donde N es el índice de la instancia, para forzar una instancia específica.
  • Cuándo se usa: El 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.
    • Valida que la instancia exista y esté conectada.
    • Elimina el patrón del mensaje antes de enviar.
El sistema genera un error si la instancia especificada no existe o no está conectada.

2. Cambio Temporal (iMessage)

Usa {TEMP-IM#N} para enviar un solo mensaje desde una cuenta diferente sin cambiar permanentemente la cuenta asignada del contacto.
  • Cuándo se usa: Quieres enviar un mensaje desde un número diferente sin cambiar la asignación de cuenta normal del contacto.
  • Ejemplo: "Actualización rápida desde nuestra línea de soporte {TEMP-IM#3}"
  • Comportamiento:
    • Enruta temporalmente el mensaje a través de la cuenta especificada.
    • No cambia la asignación de cuenta predeterminada del contacto.
    • Elimina el patrón del mensaje antes de enviar.
    • Los mensajes futuros a este contacto seguirán usando su cuenta normal.

3. Etiquetas de Contacto

Etiqueta un contacto con wa: +1234567890 (o im: / sms:) para usar siempre un número específico para ese contacto.
  • Cuándo se usa: El contacto tiene una etiqueta de número para el canal.
  • Ejemplo: Contacto etiquetado con wa: +15551234567
  • Comportamiento:
    1
    El sistema busca en las etiquetas del contacto el patrón de número del canal (wa:, im: o sms:).
    2
    Encuentra la instancia conectada cuyo número de teléfono coincide con el número etiquetado.
    3
    Si hay coincidencia, esa instancia se usa para el mensaje.
Ocurre un error si la instancia del número etiquetado no está conectada.

4. Asignación de Usuario

Cuando un contacto está asignado a un usuario en tu CRM, el sistema usa la instancia de ese usuario para el canal con el que se está enviando.
  • Cuándo se usa: El contacto está asignado a un usuario específico que tiene una instancia asignada.
  • Comportamiento:
    1
    El sistema busca el usuario al que está asignado el contacto en tu CRM.
    2
    Encuentra la instancia asignada a ese usuario para el canal que se está usando.
    3
    Si esa instancia está conectada, se usa para el mensaje.
Ocurre un error si la instancia del usuario asignado no está conectada.

5. Instancia Predeterminada

Establece siempre una instancia como “predeterminada” para cada ubicación para asegurar un comportamiento de respaldo confiable.
  • Cuándo se usa: No se resuelve ninguna anulación, etiqueta ni asignación de usuario específica.
  • Comportamiento:
    • Usa la instancia marcada como “predeterminada” para la ubicación.
    • Solo considera instancias conectadas.

6. Cualquier Instancia Disponible

  • Cuándo se usa: Como último recurso.
  • Comportamiento:
    • Selecciona cualquier instancia conectada con un número de teléfono.
Si no hay ninguna instancia conectada disponible en este punto, el mensaje falla (WhatsApp devuelve el Error 106). Consulta Errores de Selección de Número.

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 demás 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 las anulaciones manuales

Asegura que los patrones { WA#N } / {IM#N} hagan referencia a instancias existentes y conectadas.
2

Mantén las etiquetas de contacto

Mantén las etiquetas wa:, im: y sms: 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 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 los problemas

Mantén un registro de problemas comunes y soluciones.

¿Qué Sigue?


Soporte

Si necesitas ayuda con la configuración o incorporación: