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

# DM de Automação Enviada mas Não Entregue

> Por que uma DM de automação do Instagram consta como enviada e não chega, o papel de Message requests e conversas existentes e limites de private replies.

Se uma [automação acionada por comentário](https://www.ayrshare.com/docs/apis/automations/overview.md) reporta uma activity com `status: "sent"` mas a pessoa que comentou diz que nunca recebeu a DM, isso quase sempre são as configurações de privacidade do Instagram do destinatário — **não** um bug na sua automação ou na Ayrshare.

> [!NOTE]
>
> **`sent` significa que o Instagram aceitou a mensagem, não que ela foi entregue.** O Instagram não expõe a entrega de mensagens em nenhuma superfície de API. A Ayrshare marca uma action `send_dm` como `sent` no instante em que o Instagram a aceita; se ela realmente chega ao destinatário é decidido por configurações que a Ayrshare não pode ler nem alterar.

## A configuração "Message requests" do destinatário decide a entrega

Todo usuário do Instagram controla quem pode enviar uma solicitação de mensagem em **Settings and activity → Messages and story replies → Message requests**. As opções são, aproximadamente, "Todos", "Seus seguidores" e "Ninguém".

Quando sua automação envia uma DM para alguém que restringiu as solicitações de mensagem, a Meta aceita a solicitação, retorna uma **resposta de sucesso com um ID de mensagem** e então **descarta silenciosamente a mensagem**. Não há erro, nem webhook de falha, nem sinal de entrega/leitura — o descarte é invisível em toda camada de API. A Meta sabe que a mensagem é não entregável (a UI do próprio app dela mostra *"This account can't receive your message because they don't allow new message requests from everyone"*), mas ela não expõe isso na API.

| Configuração Message requests do destinatário | O que acontece |
| - | - |
| Todos | Entregue — chega como uma **solicitação de mensagem** que o destinatário precisa aceitar |
| Seus seguidores (e o destinatário não segue o remetente) | Aceita pela Meta e depois descartada silenciosamente |
| Ninguém | Aceita pela Meta e depois descartada silenciosamente |

## Uma conversa existente sobrescreve a configuração

Se o remetente e o destinatário **já possuem uma thread de mensagens** (por exemplo, o destinatário já enviou DM para a conta antes), essa conversa existente sobrescreve a configuração Message requests e a DM da automação é entregue na thread existente em vez de como uma nova solicitação. É por isso que a mesma automação pode alcançar alguns comentaristas e outros não, e por que um destinatário que enviar mensagem primeiro para a conta passará a receber DMs de automação de forma confiável.

## Como reconhecer isso

<ul>
  <li>A linha de activity mostra `status: "sent"` sem `errorDetails`.</li>
  <li>O destinatário relata que não recebeu DM (e ela não está na pasta de solicitações de mensagem dele).</li>
  <li>É intermitente entre destinatários — alguns recebem a DM, outros não — sem padrão na sua configuração.</li>
</ul>

Esse é um resultado de entrega, não um estado de falha, portanto nunca aparecerá como `failed`. Uma linha `failed` significa que o Instagram *rejeitou* o envio, e o motivo está em `actionResults[].errorDetails` — essa é uma situação diferente (consulte [códigos de erro](https://www.ayrshare.com/docs/errors/errors-ayrshare.md)).

## O que você pode fazer

**Não existe workaround programático** — nenhuma API, scope ou formato de envio pode contornar a configuração Message requests de um destinatário. O que você pode fazer:

<ul>
  <li>Alinhe expectativas de antemão: uma DM acionada por comentário só alcança pessoas cujas configurações do Instagram permitem solicitações de mensagem, ou que já têm uma conversa com sua conta.</li>
  <li>Incentive os comentaristas a mandarem DM para sua conta (ou a ativarem as solicitações de mensagem) se quiserem o follow-up — uma mensagem recebida abre a thread permanentemente.</li>
  <li>Considere uma resposta pública ao comentário como caminho alternativo para alcançar todos.</li>
</ul>

## Como DMs acionadas por comentário são enviadas (private replies)

Automações acionadas por comentário entregam a DM via **private replies** do Instagram, ancoradas ao próprio comentário. Isso é o que permite à automação enviar mensagem a um autor de comentário para quem você nunca enviou mensagem antes. Vale conhecer a mecânica — e seus limites:

<ul>
  <li>**Janela de 7 dias ancorada ao comentário.** A resposta deve ser enviada dentro de 7 dias após o comentário. Depois disso, a janela fecha e o envio falha com [`code: 491`](https://www.ayrshare.com/docs/errors/errors-ayrshare#automation-private-reply-comment-dm-errors).</li>
  <li>**Uma resposta por comentário, para sempre.** O Instagram permite apenas uma única private reply por comentário. Uma segunda tentativa falha com [`code: 491`](https://www.ayrshare.com/docs/errors/errors-ayrshare#automation-private-reply-comment-dm-errors) — o Instagram reporta "já respondido" pelo mesmo erro compartilhado que usa para uma janela fechada, então verifique `errorDetails` para saber qual foi.</li>
  <li>**Chega como uma solicitação de mensagem.** Mesmo uma private reply entregue com sucesso cai na pasta de solicitações de mensagem do destinatário e precisa ser aceita — a menos que já exista uma conversa.</li>
  <li>**A entrega ainda depende das configurações do destinatário.** As private replies removem o requisito "deve ter enviado mensagem primeiro", mas **não** sobrescrevem a configuração Message requests do destinatário, que é a limitação descrita acima.</li>
</ul>

## Relacionados

<ul>
  <li>[Visão geral da Automations API](https://www.ayrshare.com/docs/apis/automations/overview.md) — referência de triggers e actions, status de activity.</li>
  <li>[Visão geral da Messages API](https://www.ayrshare.com/docs/apis/messages/overview.md) — o toggle de privacidade de DM e a janela de messaging de 7 dias do Instagram.</li>
  <li>[Códigos de erro de private reply de automação](https://www.ayrshare.com/docs/errors/errors-ayrshare.md#automation-private-reply-comment-dm-errors) — `490`–`495`.</li>
</ul>


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