> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Selección de Número

> El algoritmo basado en prioridades que decide desde qué número se envía un mensaje saliente - común a WhatsApp, iMessage y SMS - y la sintaxis de etiquetas y anulaciones de cada canal.

<Info>
  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.
</Info>

## Jerarquía de Prioridad de Selección[​](#jerarquia-de-prioridad-de-seleccion "Enlace directo a 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:

| Prioridad       | Regla                        | Cómo se activa                                                                          |
| --------------- | ---------------------------- | --------------------------------------------------------------------------------------- |
| 1 (la más alta) | **Anulación Manual**         | El mensaje contiene un patrón de anulación (ej. `{ WA#N }`, `{IM#N}`)                   |
| 2               | **Cambio Temporal**          | El mensaje contiene un patrón de cambio temporal (ej. `{TEMP-IM#N}`) - solo ese mensaje |
| 3               | **Etiquetas de Contacto**    | El contacto está etiquetado con un número (ej. `wa:`, `im:`, `sms:`)                    |
| 4               | **Asignación de Usuario**    | El contacto está asignado a un usuario que tiene una instancia asignada                 |
| 5               | **Instancia Predeterminada** | Hay una instancia predeterminada configurada para la ubicación                          |
| 6 (la más baja) | **Cualquiera Disponible**    | Recurre a cualquier instancia conectada                                                 |

<Note>
  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](/es/multiple-instances/number-selection-errors).
</Note>

## Referencia de Sintaxis por Canal[​](#referencia-de-sintaxis-por-canal "Enlace directo a 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.

| Capacidad                    | WhatsApp          | iMessage          | SMS                |
| ---------------------------- | ----------------- | ----------------- | ------------------ |
| Anulación manual             | `{ WA#N }`        | `{IM#N}`          | -                  |
| Cambio temporal (un mensaje) | -                 | `{TEMP-IM#N}`     | -                  |
| Etiqueta de contacto         | `wa: +1234567890` | `im: +1234567890` | `sms: +1234567890` |

<Tip>
  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.
</Tip>

## Reglas de Prioridad en Detalle[​](#reglas-de-prioridad-en-detalle "Enlace directo a Reglas de Prioridad en Detalle")

### 1. Anulación Manual[​](#anulacion-manual "Enlace directo a Anulación Manual")

<Check>
  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.
</Check>

* **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.

<Warning>
  El sistema genera un error si la instancia especificada no existe o no está conectada.
</Warning>

### 2. Cambio Temporal (iMessage)[​](#cambio-temporal "Enlace directo a Cambio Temporal")

<Check>
  Usa `{TEMP-IM#N}` para enviar un solo mensaje desde una cuenta diferente sin cambiar permanentemente la cuenta asignada del contacto.
</Check>

* **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[​](#etiquetas-de-contacto "Enlace directo a Etiquetas de Contacto")

<Check>
  Etiqueta un contacto con `wa: +1234567890` (o `im:` / `sms:`) para usar siempre un número específico para ese contacto.
</Check>

* **Cuándo se usa:** El contacto tiene una etiqueta de número para el canal.
* **Ejemplo:** Contacto etiquetado con `wa: +15551234567`
* **Comportamiento:**

  <Steps>
    <Step>
      El sistema busca en las etiquetas del contacto el patrón de número del canal (`wa:`, `im:` o `sms:`).
    </Step>

    <Step>
      Encuentra la instancia conectada cuyo número de teléfono coincide con el número etiquetado.
    </Step>

    <Step>
      Si hay coincidencia, esa instancia se usa para el mensaje.
    </Step>
  </Steps>

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

### 4. Asignación de Usuario[​](#asignacion-de-usuario "Enlace directo a Asignación de Usuario")

<Check>
  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.
</Check>

* **Cuándo se usa:** El contacto está asignado a un usuario específico que tiene una instancia asignada.
* **Comportamiento:**

  <Steps>
    <Step>
      El sistema busca el usuario al que está asignado el contacto en tu CRM.
    </Step>

    <Step>
      Encuentra la instancia asignada a ese usuario para el canal que se está usando.
    </Step>

    <Step>
      Si esa instancia está conectada, se usa para el mensaje.
    </Step>
  </Steps>

<Warning>
  Ocurre un error si la instancia del usuario asignado no está conectada.
</Warning>

### 5. Instancia Predeterminada[​](#instancia-predeterminada "Enlace directo a Instancia Predeterminada")

<Check>
  Establece siempre una instancia como "predeterminada" para cada ubicación para asegurar un comportamiento de respaldo confiable.
</Check>

* **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[​](#cualquier-instancia-disponible "Enlace directo a Cualquier Instancia Disponible")

* **Cuándo se usa:** Como último recurso.
* **Comportamiento:**
  * Selecciona cualquier instancia conectada con un número de teléfono.

<Warning>
  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](/es/multiple-instances/number-selection-errors).
</Warning>

## Ejemplos de Configuración Avanzada[​](#ejemplos-de-configuracion-avanzada "Enlace directo a Ejemplos de Configuración Avanzada")

### Ejemplo 1: Configuración de Comercio Electrónico[​](#ejemplo-1-configuracion-de-comercio-electronico "Enlace directo a Ejemplo 1: Configuración de Comercio Electrónico")

```text theme={null}
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[​](#ejemplo-2-gestion-de-clientes-de-agencia "Enlace directo a Ejemplo 2: Gestión de Clientes de Agencia")

```text theme={null}
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[​](#mejores-practicas "Enlace directo a Mejores Prácticas")

### Recomendaciones de Configuración[​](#recomendaciones-de-configuracion "Enlace directo a Recomendaciones de Configuración")

<Steps>
  <Step title="Siempre establece una predeterminada">
    Asegura que una instancia esté marcada como predeterminada para escenarios de respaldo.
  </Step>

  <Step title="Documenta tu estrategia">
    Mantén un registro de qué números se usan para qué propósitos.
  </Step>

  <Step title="Prueba tu configuración">
    Envía mensajes de prueba para verificar que la selección de número funcione como se espera.
  </Step>

  <Step title="Monitorea regularmente">
    Revisa el estado de conexión de las instancias diariamente.
  </Step>
</Steps>

### Prevención de Errores[​](#prevencion-de-errores "Enlace directo a Prevención de Errores")

<Steps>
  <Step title="Valida las anulaciones manuales">
    Asegura que los patrones `{ WA#N }` / `{IM#N}` hagan referencia a instancias existentes y conectadas.
  </Step>

  <Step title="Mantén las etiquetas de contacto">
    Mantén las etiquetas `wa:`, `im:` y `sms:` actualizadas cuando cambien las instancias.
  </Step>

  <Step title="Revisa las asignaciones de usuarios">
    Verifica regularmente que los usuarios asignados tengan instancias conectadas.
  </Step>

  <Step title="Monitoreo de salud">
    Configura alertas para desconexiones de instancias.
  </Step>
</Steps>

### Flujo de Solución de Problemas[​](#flujo-de-solucion-de-problemas "Enlace directo a Flujo de Solución de Problemas")

<Steps>
  <Step title="Revisa el código de error">
    Identifica el error específico (101-106).
  </Step>

  <Step title="Verifica el estado de la instancia">
    Confirma qué instancias están conectadas.
  </Step>

  <Step title="Revisa la configuración">
    Verifica asignaciones de usuarios, etiquetas y configuraciones predeterminadas.
  </Step>

  <Step title="Prueba la resolución">
    Envía un mensaje de prueba para verificar que la solución funcionó.
  </Step>

  <Step title="Documenta los problemas">
    Mantén un registro de problemas comunes y soluciones.
  </Step>
</Steps>

## ¿Qué Sigue?[​](#que-sigue "Enlace directo a ¿Qué Sigue?")

* [**Errores de Selección de Número**](/es/multiple-instances/number-selection-errors): Códigos de error 101-106 y cómo resolverlos
* [**Resumen de Múltiples Instancias**](/es/multiple-instances/overview): Casos de uso, beneficios y configuración
* [**Guía de Configuración Completa**](/es/whatsapp/full-setup): Conecta instancias y configura asignaciones

***

## Soporte[​](#soporte "Enlace directo al Soporte")

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

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)
