Plataforma do Messenger

Mensagens do Instagram na plataforma do Messenger

On July 23, 2024 we launched the new Instagram API with Instagram Login. An Instagram professional account – Business or Creator account – will no longer need to be linked to a Facebook Page in order to have conversations with customers, followers, or Instagram users interested in their business or Instagram account, manage comments, or publish media. Learn more about this new version in our blog post.

See our Instagram API with Instagram Login to learn more.

A plataforma do Messenger permite que você crie soluções de mensagem em escala para contas profissionais do Instagram.

O recurso Mensagens do Instagram está disponível para estas contas:

  • Contas profissionais do Instagram para empresas
  • Contas profissionais do Instagram para criadores de conteúdo

É possível verificar a qualificação das contas que você gerencia por meio da API de Conversas . Um código de erro 36103 será retornado se o recurso de mensagens ainda não estiver disponível.

Usos comuns

  • Receber as mensagens enviadas por clientes para sua Caixa de Entrada profissional do Instagram
  • Receber e responder mensagens de clientes com texto, mídia, stories e muito mais
  • Enviar uma resposta privada para uma pessoa que fez uma publicação aberta no seu Instagram
  • Enviar uma resposta privada para uma pessoa que fez um comentário na sua publicação no Instagram

Como funciona

A plataforma do Messenger permite que você converse com pessoas interessadas na sua empresa ou nas suas criações. A Página do Facebook vinculada à sua conta profissional do Instagram facilita essas conversas por meio da plataforma do Messenger. Quando uma pessoa enviar uma mensagem ao seu Instagram, você a receberá na Caixa de Entrada. Além disso, uma notificação de webhook será enviada ao seu servidor. Seu app de mensagens tem 24 horas para responder à mensagem. Caso seja necessário mais tempo para permitir que um agente humano responda, é possível adicionar uma tag à resposta para enviá-la fora da janela-padrão de mensagens de 24 horas.

As Mensagens do Instagram oferecem diversos pontos de entrada para as pessoas iniciarem conversas e tipos de mensagem para o app responder.

Caixa de Entrada do Instagram

As contas profissionais do Instagram têm uma Caixa de Entrada de mensagens que permite o controle das notificações e a organização das mensagens. Por padrão, as notificações ficam desativadas. Para ativá-las, acesse as configurações da Caixa de Entrada. A Caixa de Entrada é organizada conforme as seguintes categorias: Principal, Geral e Solicitações. Por padrão, todas as novas conversas com seguidores aparecerão na pasta Principal. As conversas anteriores à implementação das Mensagens do Instagram estarão na pasta em que você as colocou.

As mensagens recebidas de pessoas que não seguem sua conta ficam na pasta Solicitações. É possível aceitar ou recusar essas solicitações. Vale destacar que as mensagens serão marcadas como Visto apenas se você as aceitar. Depois de aceitar a solicitação, você poderá mover a conversa para a pasta Principal ou Geral. Todas as solicitações de mensagens respondidas por meio de apps de terceiros serão movidas para a pasta Geral.

Limitações da Caixa de Entrada

  • Se você responder a uma mensagem por meio de um app de terceiros, a conversa será movida para a pasta Geral independentemente da configuração.
  • As pastas da Caixa de Entrada não são compatíveis com a plataforma do Messenger, e mensagens enviadas por meio dela não incluirão as informações de pasta exibidas no app do Instagram from Meta.
  • As notificações de webhooks ou as mensagens entregues por meio da API não serão consideradas como Lida na Caixa de Entrada do app do Instagram. Uma mensagem só será considerada Lida após o envio de uma resposta.

Login empresarial do Instagram

No dia 9 de novembro de 2022, apresentamos o Login de Empresa no Instagram. Esse fluxo de login permite que uma pessoa converta a própria conta do Instagram em uma conta profissional, crie uma Página do Facebook para a empresa e conecte a Página à conta profissional do Instagram.

Requisitos

Este guia considera que você leu a Overview for the Messenger Platform e implementou os componentes necessários para enviar e receber mensagens e notificações.

  • Graph API do Instagram: permite que empresas e criadores de conteúdo usem seu app para gerenciar a própria presença no Instagram
  • As seguintes permissões:
    • instagram_basic
    • instagram_manage_messages
    • pages_manage_metadata
    • pages_showlist
    • business_management
  • Excluir as mensagens ao receber uma notificação de webhooks que solicita isso

Experiências automatizadas

É possível fornecer um caminho de escalação para experiências de mensagens automatizadas usando uma destas opções:

  • Um app único: é possível criar uma Caixa de Entrada personalizada para receber ou responder a mensagens de uma pessoa. A Caixa de Entrada personalizada tem a tecnologia do mesmo app de mensagens que fornece a experiência automatizada.
  • Vários apps: o protocolo de entrega permite que você passe a conversa de um app ou uma Caixa de Entrada para outro. Por exemplo, um app administraria a conversa com uma experiência automatizada; quando necessário, outro app receberia a conversa para passá-la a um agente humano.

Como informar os usuários sobre sua experiência automatizada

Quando exigido por lei aplicável, as experiências de bate-papo automatizado devem deixar claro que a pessoa está interagindo com um serviço automatizado:

  • no início de qualquer conversa ou tópico de mensagem,
  • após um intervalo de tempo significativo, ou
  • quando o bate-papo deixa de ser uma interação humana para se tornar uma experiência automatizada.

As experiências de bate-papo automatizado que atendem aos seguintes grupos devem se atentar especialmente a este requisito:

  • Mercado ou usuários da Califórnia
  • Mercado ou usuários da Alemanha

As divulgações incluem, entre outros: “Sou o bot da página [Nome da Página]”, “Você está interagindo com uma experiência automatizada”, “Você está falando com um bot” ou “Eu sou um bot de bate-papo automatizado.”

Mesmo que não seja legalmente exigido, recomendamos informar aos usuários quando estiverem interagindo com um bate-papo automatizado como boa prática, uma vez que isso ajuda a gerenciar as expectativas do usuário sobre a interação dele com sua experiência de troca de mensagens.

Visite nossas Políticas de Desenvolvedor para obter mais informações.

Somente agente humano

Com uma Caixa de Entrada personalizada, é possível fornecer um caminho de escalação para experiências de mensagens somente com agente humano. Seu app de mensagens precisa:

  • receber mensagens enviadas por pessoas e renderizá-las corretamente na Caixa de Entrada personalizada;
  • responder a mensagens por meio da Caixa de Entrada personalizada e garantir que as pessoas as recebam.

Limitações

  • Uma conta profissional do Instagram só pode interagir com um cliente por conversa. Não há compatibilidade com mensagens em grupo.
  • As conversas na pasta de solicitações que estiverem inativas por 30 dias não serão retornadas nas chamadas de API.
  • Apenas o URL da publicação ou mídia compartilhada é incluído na notificação de webhook quando um cliente envia uma mensagem com compartilhamento.
  • Para receber webhooks, a conta profissional do Instagram de criador deve enviar uma solicitação usando a API de Conversas do Instagram.

Limitações do teste

  • Os apps com acesso padrão só podem interagir com pessoas que têm uma função no app.
  • Talvez algumas ferramentas não funcionem corretamente antes de o app receber acesso avançado.
  • As pessoas que testam o app precisam ter uma função nele, conceder acesso a todas as permissões necessárias e ter uma função na conta profissional do Instagram.

Próximas etapas

Veja também