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

# Identificadores del remitente

> Consulta cuándo from, instanceId y otros selectores aceptan un identificador legible en lugar del ID interno.

## En pocas palabras

* `from` acepta valores distintos según el canal: teléfono, dirección, @usuario o nombre del recurso.
* Cuando se envía un ID o alias, el backend lo busca dentro del workspace de la clave API y respeta las restricciones de recursos de la clave.
* Prefiere los IDs en integraciones permanentes; los alias facilitan la configuración y la lectura del payload.

## Qué acepta cada canal

| Canal / recurso | Valores aceptados en `from` |
| - | - |
| WhatsApp — mensajes | ID de la instancia, teléfono E.164 de la línea o nombre de la instancia. También acepta ID o nombre de un pool de envío. |
| WhatsApp — presencia y llamadas | ID, teléfono E.164 o nombre de la instancia. Los pools no se aplican a presencia ni llamadas. |
| Instagram | ID de instancia, nombre o usuario de la cuenta conectada, con o sin `@` (por ejemplo, `tienda` o `@tienda`). |
| Telegram | ID de instancia, nombre o username del bot, con o sin `@` (por ejemplo, `avisos` o `@avisos_bot`). |
| RCS | ID o nombre de la instancia/agente de marca. |
| Push | ID o nombre de la app. `pushAppId` sigue disponible en las rutas que mantienen ese campo legado. |
| SMS y voz | ID del número de origen o teléfono E.164 activo y disponible para el workspace. |
| Correo | Dirección de correo del remitente en un dominio verificado, opcionalmente con nombre visible, como `Soporte <ayuda@ejemplo.com>`. No es un ID de instancia. |

Cada endpoint documenta su propio campo. Por ejemplo, la presencia de WhatsApp acepta `from` y conserva `instanceId` como alias legado; la API de envío de correo espera una dirección en `from`.

## Ejemplo: seleccionar Instagram por @usuario

Usa el username de la cuenta de Instagram conectada para seleccionar la cuenta remitente:

```json theme={null}
{
  "from": "@mitienda",
  "to": ["17841400000000000"],
  "type": "text",
  "payload": { "text": "¡Hola!" }
}
```

`to` sigue siendo el identificador del destinatario requerido por la API oficial (IGSID). `@` solo selecciona la cuenta de origen.

## Si un alias no identifica una sola cuenta

Si hay nombres repetidos que coinciden con más de un recurso, la API devuelve `409 AMBIGUOUS_SENDER` y solicita el ID del recurso. Un alias de otro workspace nunca selecciona recursos de allí: la búsqueda se limita al workspace de la clave API. Las restricciones `instanceIds`, `pushAppIds` y equivalentes siguen vigentes después de resolver el alias.

El campo legado `instanceId` sigue aceptándose en las rutas que lo declaran. En las rutas con `from`, ese es el campo preferido. Consulta la referencia del canal para confirmar qué alias acepta cada operación.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.