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

# Visão geral da Messages API

> Envie e receba mensagens diretas no Facebook, Instagram e X/Twitter

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["business"]} maxPackRequired={false} />

A Messaging API permite gerenciar mensagens diretas (DM) com os interlocutores que entram em contato com seus User Profiles.
Um interlocutor é a pessoa com quem seu usuário (User Profile) está se comunicando.
Uma conversa é uma série de mensagens entre seu usuário (User Profile) e seu interlocutor.

<ul class="custom-bullets">
  <li>
    A Messaging API está incluída em todos os Ayrshare Business Plans e como um
    add-on pago para os planos Premium.
  </li>

  <li>
    Tanto para os planos Business quanto Premium, você deve ativar o Messaging na
    página Account do dashboard da Ayrshare.
  </li>

  <li>
    O Messaging está disponível para Facebook Messenger, Instagram Direct Messenger
    e X Direct Messages.
  </li>
</ul>

<Card title="Saiba mais sobre a Messaging API" icon="link" href="https://www.ayrshare.com/ayrshare-messaging-api-for-facebook-instagram-and-x-twitter/" horizontal />

## Principais recursos de Messaging

<ul class="custom-bullets">
  <li>Gerencie as conversas dos seus usuários com os interlocutores.</li>

  <li>
    Envie mensagens de texto, imagem, vídeo e emoji em nome dos seus usuários.
  </li>

  <li>Recupere históricos completos de conversas.</li>
  <li>Configure respostas automáticas.</li>

  <li>
    Receba atualizações em tempo real via webhooks para mensagens recebidas,
    reações e confirmações de leitura.
  </li>
</ul>

## Habilitar Messaging

### Habilitar sua conta Ayrshare e User Profiles

Primeiro, você deve habilitar o Messaging para sua conta Ayrshare geral para gerenciar DMs. No dashboard da Ayrshare, vá para a [página Account](https://app.ayrshare.com/account) e clique no botão "Learn More" e, em seguida, em "Enable". Nesse momento, você habilitou o Messaging para sua conta geral, *mas ainda não ativou o Messaging para User Profiles individuais*.

Você pode ativar o Messaging para User Profiles individuais na [página User Profiles](https://app.ayrshare.com/manage-profiles), clicando na caixa de seleção "Messaging Active" para cada perfil, ou usando o [endpoint de criação ou atualização de profiles](/apis/profiles/overview).

Após habilitar o Messaging para um User Profile, você deve vincular novamente a conta social (Facebook e Instagram) na página Social Accounts/Social Linking.
Uma vez habilitado, você verá o selo "Messaging" na conta social vinculada.

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/messaging/messaging-badge.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=cee009857e195b2835e913eb36c3b83f" width="60%" alt="Messaging badge" class="center" data-path="images/apis/messaging/messaging-badge.webp" />

### Habilitar Messaging no aplicativo do Instagram

Talvez seja necessário habilitar o messaging para sua conta do Instagram:

<ul class="custom-bullets">
  <li>
    Vá para o seu perfil no aplicativo móvel do Instagram e toque no ícone de menu ≡ no
    canto superior direito para ir para a página **Configurações e atividade**.
  </li>

  <li>Role até a seção **Como outras pessoas podem interagir com você**.</li>
  <li>Clique em **Mensagens e respostas de story**.</li>
  <li>Toque em **Solicitações de mensagem**.</li>

  <li>
    Em **Ferramenta conectada**, ative o botão **Permitir acesso a mensagens**.
  </li>
</ul>

## Informações importantes sobre Messaging

<Note>
  **A conversa deve ser iniciada pelo interlocutor.** Uma vez que a conversa
  esteja estabelecida, você pode enviar mensagens livremente, receber mensagens, obter
  reações (por exemplo, curtidas) ou obter confirmações de leitura em nome dos seus usuários.
</Note>

<Note>
  **Seu usuário deve responder a uma conversa do Instagram dentro de 7 dias após a última
  mensagem enviada pelo interlocutor.** Se o interlocutor não tiver enviado uma mensagem em
  7 dias, a conversa é considerada inativa e não pode receber resposta.
</Note>

### Recuperação do histórico de mensagens para Facebook e Instagram

Ao habilitar o Messaging pela primeira vez para um user profile com um Facebook ou
Instagram vinculado, existem limitações importantes ao acessar o histórico de conversas:

#### Limitações da conexão inicial

<ul class="custom-bullets">
  <li>
    Facebook e Instagram só permitem a recuperação das **últimas 20 mensagens** de
    conversas existentes quando você vincula uma conta para messaging pela primeira vez
  </li>

  <li>
    Se uma conversa tiver mais de 20 mensagens, apenas as 20 mais recentes serão
    acessíveis inicialmente
  </li>
</ul>

#### Após a configuração inicial

<ul class="custom-bullets">
  <li>
    Uma vez que o messaging esteja habilitado, **todas as novas mensagens** enviadas e recebidas serão
    totalmente acessíveis
  </li>

  <li>
    A Ayrshare mantém o histórico completo de conversas a partir de então
  </li>

  <li>
    Por exemplo: se você inicialmente recuperar 20 mensagens e depois 100 novas mensagens
    forem trocadas, você poderá acessar todas as 120 mensagens no total
  </li>
</ul>

Esta limitação só se aplica a mensagens históricas que existiam antes de habilitar o
messaging - toda a atividade futura de conversas no Facebook e no Instagram será
totalmente preservada e acessível.

### Limite de conversas e preços

<ul class="custom-bullets">
  <li>
    Cada Ayrshare User Profile pode ter até **1.000 conversas ativas por
    ciclo de cobrança**. A contagem de conversas ativas é a soma de todas as redes
    sociais.
  </li>

  <li>
    **Plano Premium**: o Messaging é um add-on de **US\$ 49 por mês** por conta.
  </li>

  <li>
    **Planos Launch e Business**: o Messaging é cobrado a **US\$ 0,09 por conversa
    ativa** via cobrança medida do Stripe. Descontos por volume estão
    disponíveis; entre em contato com o seu representante de conta Ayrshare para mais detalhes.
  </li>

  <li>
    Uma conversa é contada como ativa para o ciclo de cobrança quando você envia uma
    mensagem para um destinatário. Mensagens recebidas de um destinatário não marcam,
    por si só, uma conversa como ativa.
  </li>

  <li>
    Se o limite de 1.000 conversas for atingido, você ainda poderá receber
    mensagens, mas não poderá responder até o início do próximo
    ciclo de cobrança.
  </li>

  <li>
    O número de mensagens, enviadas ou recebidas, em uma conversa ativa é
    ilimitado.
  </li>

  <li>
    Se precisar aumentar o limite de conversas, entre em contato com o seu
    representante de conta Ayrshare.
  </li>
</ul>

Você pode ver a contagem atual de conversas com o [endpoint user](/apis/user/overview).

### Problemas de controle de messaging no Facebook e Instagram

A Meta (Facebook e Instagram) usa um sistema de "controle de thread" para conversas de messaging. Isso significa que apenas um app pode enviar mensagens em uma conversa por vez, enquanto outros apps só podem receber mensagens.

#### O que isso significa?

Se você ver o erro **"Message failed to send because another app is controlling this thread now"**, significa que:

* Um app de terceiros diferente controla atualmente essa conversa
* A Ayrshare só pode receber mensagens nessa conversa
* A Ayrshare não pode enviar mensagens até recuperar o controle

#### Como corrigir esse problema

Para permitir que a Ayrshare envie mensagens novamente, você precisa remover o app de terceiros que está controlando a conversa.
Observe que a Meta (Facebook e Instagram) pode atualizar o processo para remover apps de terceiros, portanto, use os passos a seguir como orientação geral.

**Para Páginas do Facebook:**

1. Acesse [Facebook.com](https://facebook.com) e faça login na sua conta
2. Clique no menu (☰) no canto superior direito → **Configurações e privacidade** → **Configurações**
3. Na barra lateral esquerda, clique em **Apps e sites**
4. Encontre o app de terceiros que está controlando o seu messaging
5. Clique em **Remover** ao lado desse app
6. Confirme a remoção

**Para contas Business do Instagram:**

1. Abra o aplicativo do Instagram no seu telefone
2. Vá para o seu **Perfil** → toque no menu (☰) → **Configurações e privacidade**
3. Toque em **Apps e sites**
4. Encontre e remova o app de terceiros

**Alternativa para Instagram:**

1. Acesse [business.facebook.com](https://business.facebook.com)
2. Navegue até **Configurações do negócio**
3. Em **Contas**, clique em **Contas do Instagram**
4. Selecione sua conta do Instagram
5. Verifique os apps conectados e remova aquele que está causando o problema

#### Após a remoção

Depois de remover o app de terceiros:

<ul class="custom-bullets">
  <li>O controle da thread retornará automaticamente para a Ayrshare</li>
  <li>Você deve conseguir enviar mensagens normalmente novamente</li>
  <li>Nenhuma ação adicional é necessária de sua parte</li>
</ul>

Se você continuar enfrentando problemas após remover o app, entre em contato com nossa equipe de suporte.

## WebHooks de mensagens

Consulte [Webhooks de mensagens](/apis/webhooks/actions#messages-action) para receber automaticamente mensagens, confirmações de leitura ou reações.