> ## 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 de remetente

> Veja quando os campos from, instanceId e os IDs de outros recursos aceitam um identificador legível em vez do ID interno.

## Em poucas palavras

* O campo `from` aceita valores diferentes conforme o canal: telefone, endereço, @usuário ou nome de recurso.
* Quando houver um ID e um alias, o backend resolve o alias dentro do workspace da chave e respeita as restrições da API Key.
* Prefira o ID do recurso em integrações persistentes; use alias quando for mais prático para configurar ou ler o payload.

## O que cada canal aceita

| Canal / recurso | Valores aceitos em `from` |
| - | - |
| WhatsApp — mensagens | ID da instância, telefone E.164 da linha ou nome da instância. Também aceita ID ou nome de pool de envio. |
| WhatsApp — presença e chamadas | ID, telefone E.164 ou nome da instância. Pools não se aplicam a presença ou chamadas. |
| Instagram | ID da instância, nome ou usuário da conta conectada, com ou sem `@` (por exemplo, `loja` ou `@loja`). |
| Telegram | ID da instância, nome ou username do bot, com ou sem `@` (por exemplo, `avisos` ou `@avisos_bot`). |
| RCS | ID ou nome da instância/agente da marca. |
| Push | ID ou nome do app. Também é possível usar `pushAppId` onde a rota mantém esse campo legado. |
| SMS e voz | ID do número de origem ou telefone E.164 ativo e disponível para o workspace. |
| E-mail | Endereço de e-mail do remetente em domínio verificado, opcionalmente com nome de exibição, como `Suporte <ajuda@exemplo.com>`. Não é um ID de instância. |

Cada endpoint documenta seu próprio campo. Por exemplo, a presença do WhatsApp aceita `from` e mantém `instanceId` como alias legado; a API de envio de e-mail espera um endereço em `from`.

## Exemplo: Instagram pelo @usuário

Use o username da conta do Instagram conectada para selecionar a instância remetente:

```json theme={null}
{
  "from": "@minhaloja",
  "to": ["17841400000000000"],
  "type": "text",
  "payload": { "text": "Olá!" }
}
```

O valor de `to` continua sendo o identificador do destinatário exigido pela API oficial (IGSID). O `@` só seleciona a conta de origem.

## Quando o alias não identificar uma única conta

Se nomes repetidos apontarem para mais de um recurso, a API responde `409 AMBIGUOUS_SENDER` e pede o ID do recurso. Um alias de outro workspace nunca seleciona recursos de lá: a busca fica limitada ao workspace da API Key. As restrições `instanceIds`, `pushAppIds` e equivalentes continuam valendo depois da resolução.

O campo legado `instanceId` continua aceito em rotas que declaram esse alias. Nas rotas com `from`, esse é o campo preferido. Consulte a referência do canal para saber se um alias específico é aceito naquela operação.


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