Este documento contém o registro de alterações das versões atuais da plataforma do Messenger. A plataforma do Messenger segue o controle de versão da Graph API.
Versão mais recente: v21.0
response_feedback
do MessengerO novo evento de webhook response_feedback
envia notificações quando um usuário fornece feedback ao clicar nos botões de polegar para cima/para baixo ou "Resposta boa"/"Resposta ruim" em uma mensagem enviada por você. Saiba mais aqui.
Agora, seu app pode fazer 300 (antes eram 100) chamadas por segundo por conta profissional do Instagram para mensagens que contenham texto, links, reações e figurinhas. Saiba mais.
Componentes da nova API do Instagram:
graph.instagram.com
instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Monitore o registro de alterações da plataforma do Instagram para ver alterações, como correções de bugs e novos recursos.
Agora, ig_reel
é um tipo de anexo compatível com webhook de mensagens. Anexos de reel do Instagram terão o tipo ig_reel
. A respectiva carga incluirá o título, o URL e o ID do vídeo.
Agora, ig_reel
e reel
são tipos de anexos compatíveis com webhook de mensagens. Anexos de reel do Instagram terão o tipo ig_reel
. A respectiva carga incluirá o título, o URL e o ID do vídeo. Anexos de reel do Facebook terão o tipo reel
. A respectiva carga incluirá o título, o URL e o ID do vídeo.
Agora, as empresas que usam o encaminhamento de conversas do Messenger podem configurar o recurso de tomada de controle de conversas no nível do app. A configuração de tomada de controle original que acompanha o app padrão ficou obsoleta, e todos os valores foram migrados. Saiba mais aqui.
Aplicável a todas as versões.
Além de ad_id
e ad_title
, o original_media_id
será retornado no objeto media
de value
do campo comments
quando alguém comentar em publicações turbinadas ou de anúncios do Instagram. Para mais informações, consulte Como configurar webhooks para o Instagram.
message_edits
O novo evento de webhook message_edits
notifica você quando um usuário edita uma mensagem existente. Saiba mais sobre esse evento de webhook aqui.
Agora, o tipo de anexo "reel" é compatível com webhooks de mensagens do Messenger. Anexos de reel serão categorizados como reel
. A respectiva carga incluirá o título, o URL e o ID do vídeo.
Os comandos são palavras-chave tocáveis que o usuário pode invocar quando quiser para realizar ações específicas na experiência do Messenger. Eles são compostos pelo comando em si e uma dica, explicando o recurso ao usuário. Por exemplo, quando escreve "preciso de ajuda para reservar voos e hotéis para o México na última semana de dezembro", o usuário invoca os comandos de voos e hotéis configurados pela empresa de viagens. Saiba mais aqui.
O menu de comandos é uma novidade que estamos lançando e aparecerá automaticamente nas configurações de comandos. Se você já tiver um menu persistente definido na experiência do Messenger, ele será substituído pelo menu de comandos. Saiba mais aqui.
Agora, as pessoas podem compartilhar sua experiência de mensagens da página do perfil comercial do Messenger. Isso ajuda a impulsionar a propaganda boca a boca da sua experiência do Messenger. Saiba mais aqui.
Os comandos aparecerão no perfil comercial assim que você configurá-los na sua experiência do Messenger. As pessoas podem navegar até o perfil comercial tocando no nome da página na parte superior e saber mais sobre os comandos disponíveis na sua experiência do Messenger.
A tela de boas-vindas mostra a lista de comandos compatíveis com a experiência de mensagens para que as pessoas possam entender melhor quais ações podem ser realizadas. Saiba mais aqui.
Se você está criando o app para enviar e receber mensagens da própria página, não será necessário passar pelo processo de análise do app. Se você planeja obter informações do perfil de usuário, será necessário passar pela análise do app para receber as permissões necessárias para acessar a API do Perfil do Usuário.
O encaminhamento de conversas já está disponível para o Instagram. Com o encaminhamento de conversas, a Meta pode mover as conversas da empresa com clientes (ou possíveis clientes) para o app especificado por você a fim de responder à conversa. Isso permite que sua empresa crie conversas avançadas com as pessoas e diminua as chamadas de API aos servidores da Meta.
O acesso à API de Rótulos Personalizados e à API de Personas foi restaurado para empresas com operações na Europa, bem como para pessoas na Europa e no Japão que se conectam com empresas no mundo todo.
Agora as empresas e agências podem facilmente conectar os próprios anúncios de clique para o Messenger e clique para o Instagram Direct a uma mensagem de boas-vindas criada em um app de parceiro sem que seja necessário usar um trecho de código JSON. A mensagem de boas-vindas aparecerá como texto suspenso no Gerenciador de Anúncios ao criar o anúncio de clique para o Messenger ou clique para o Instagram Direct. Saiba mais aqui.
As respostas privadas já estão disponíveis para comentários no Facebook Reels.
Atualizamos o recurso de respostas privadas para grupos, incluindo novos campos compatíveis com informações relacionadas à pessoa que fez um comentário via from
e ao contexto principal pelo parent_id
no webhook group_feed
. Talvez seja preciso atualizar seu servidor de webhooks para gerenciar esses novos campos.
Como empresa, você pode usar vários provedores de mensagens para diferentes conversas com os clientes, como geração de leads, ofertas de marketing sobre seus produtos ou perguntas de suporte ao cliente. O encaminhamento de conversas permite definir quais empresas parceiras controlam a troca de mensagens com os clientes em determinado momento para que eles recebam as informações necessárias. Você pode criar e gerenciar regras de encaminhamento de mensagens nas configurações da Página.
O modelo de botão envia uma mensagem de texto com até três botões anexados. Isso é útil para oferecer opções de escolha ao destinatário da mensagem, como respostas predeterminadas a uma pergunta ou ações a serem tomadas. Estes são os botões compatíveis: postback
e web_url
.
Como empresa, você pode usar vários provedores de mensagens para diferentes conversas com os clientes, como geração de leads, ofertas de marketing sobre seus produtos ou perguntas de suporte ao cliente. O encaminhamento de conversas permite definir quais empresas parceiras controlam a troca de mensagens com os clientes em determinado momento para que eles recebam as informações necessárias. Você pode criar e gerenciar regras de encaminhamento de mensagens nas configurações da Página.
O modelo de botão envia uma mensagem de texto com até três botões anexados. Isso é útil para oferecer opções de escolha ao destinatário da mensagem, como respostas predeterminadas a uma pergunta ou ações a serem tomadas. Estes são os botões compatíveis: postback
e web_url
.
As mensagens do Instagram estão disponíveis para todas as contas profissionais do Instagram de empresa ou criador de conteúdo.
Agora você pode adicionar comandos interativos para permitir que clientes ou pessoas interessadas liguem para sua empresa.
É possível criar anúncios que incluem um fluxo de clique para assinar. Com isso, você pode enviar solicitações a clientes ou pessoas interessadas para que aceitem receber mensagens de marketing.
O roteamento entre apps está disponível no Instagram Direct e no Messenger.
Respostas privadas
Agora, sua empresa pode enviar respostas privadas a pessoas que comentaram em publicações de Grupos do Facebook.
Notificações recorrentes
As notificações recorrentes agora são chamadas de mensagens de marketing.
Modelos
Um modelo estruturado agora está disponível para reunir informações de entrega de um cliente.
API de Insights sobre Mensagens
Estão disponíveis novas métricas e parâmetros para a API de Insights sobre Mensagens .
Notificações recorrentes na plataforma do Messenger
A propriedade title
para solicitações de aceitação de notificações recorrentesnão é mais obrigatória. Se title
não for definido, o valor será "Atualizações e promoções" por padrão. Essa alteração é válida para solicitações de aceitação enviadas de uma Página do Facebook ou de contas profissionais do Instagram.
Notificações recorrentes na plataforma do Messenger
A propriedade notification_messages_frequency
de solicitações para aceitação de notificações recorrentes está obsoleta e não será mais retornada em solicitações GET
nem em notificações de webhook. No entanto, os tokens de mensagem de notificação criados antes de 2 de fevereiro de 2023 para notificações recorrentes semanais ou mensais serão compatíveis. Além disso, notification_message_frequency
será retornada nas notificações de webhook.
Agora é possível enviar até três mensagens de acompanhamento a uma pessoa que aceitou receber notificações recorrentes. Depois de enviar a primeira mensagem desse tipo, as mensagens restantes devem ser enviadas dentro de dois minutos.
O ponto de extremidade GET /PAGE-ID/notification_message_tokens
já está disponível para Mensagens do Instagram.
Agora a propriedade next_eligible_time
está disponível para os pontos de extremidade de token de mensagem de notificação. Esse campo retorna o horário disponível para envio da próxima notificação recorrente usando o token de mensagem de notificação.
Messenger API for Instagram
Agora é possível incluir GIFs em mensagens enviadas de contas profissionais do Instagram usando a Messenger API for Instagram.
A API de Carregamento de Anexos passou a ser compatível com o carregamento de mídia em mensagens enviadas de contas profissionais do Instagram.
As informações de referência sobre anúncios de clique para conversa do Instagram (CTD, pelas iniciais em inglês) agora são retornadas em notificações de webhook de mensagens.
A partir de 31 de março de 2023, não será mais possível baixar arquivos CSV no painel de Análises do Messenger. Visite a API de Insights sobre Mensagens para saber como obter essas informações.
O Login de Empresa no Instagram facilita a integração de usuários do Instagram que ainda precisam configurar uma conta para acesso à API por meio de pop-ups modais e menos etapas.
Facilitamos o acompanhamento de anúncios de geração de leads que redirecionam pelo clique para o Messenger por meio das seguintes novidades:
A API de Eventos de Mensagens é compatível com o evento lead_submitted
. As empresas podem usar esse evento para relatar envios de leads a partir de anúncios de clique para o Messenger. Esse novo evento de mensagens é lançado como uma versão beta pública. A geração de relatórios no Gerenciador de Anúncios será lançada em breve.
O menu persistente já está disponível para mensagens do Instagram.
Agora, as mensagens do Instagram têm compatibilidade com respostas privadas a comentários em stories ao vivo do Instagram e em publicações de anúncio. Talvez seja preciso atualizar seu servidor de webhooks para gerenciar esses novos campos.
Agora é possível obter uma lista de todos os tokens de mensagem de notificação válidos usando o ponto de extremidade GET /PAGE-ID/notification_message_tokens
.
Os IDs do app não podem mais ser associados a tokens de mensagem de notificação. Agora, todos os apps vinculados a uma Página receberão notificações de webhook de aceitação quando uma pessoa aceitar receber notificações recorrentes.
Adicionamos os seguintes campos de carga do anexo da mensagem.
image_aspect_ratio
: defina uma imagem para uma taxa de proporção horizontal ou quadrada para pedidos de aceitaçãoelements
: crie um carrossel de imagens para pedidos de aceitaçãonotification_message_tokens
: obtenha uma lista dos tokens de mensagem de notificações atuais notification_messages_cta_text
: personalize o texto de chamadas para ação de pedidos de aceitaçãoAdicionamos as seguintes formas de obter aceitação para notificações recorrentes:
O campo title
foi adicionado aos webhooks de notificações recorrentes.
A resposta privada está disponível para comentários em Reels no Instagram.
Agora é possível enviar mensagens do Instagram com áudio ou vídeo carregado em um servidor da Meta ou enviado do seu servidor.
A API do perfil do usuário é compatível com a recuperação do campo nome de usuário do cliente do Instagram na versão 14.0 e posteriores da Graph API.
As notificações recorrentes são uma atualização importante na Messenger API para permitir que as empresas enviem mensagens proativas e automatizadas que gerem reengajamento. Esse recurso ajuda as empresas na entrega de mensagens personalizadas e focadas no cliente em cada etapa da jornada do cliente.
Notificações recorrentes na Messenger API for InstagramApresentamos a versão beta das notificações recorrentes na Messenger API for Instagram. Os desenvolvedores podem se cadastrar na lista de interesse até julho.
Aumento da limitação de volume da Send API do InstagramEm cada conta profissional do Instagram, aumentamos a limitação de volume da Send API para 100 chamadas de API por segundo.
Parâmetro de referência ig.meÉ possível adicionar um link ig.me a sites, emails e pacotes de produtos para permitir que os usuários iniciem uma conversa com a empresa no Instagram de forma fácil. Além disso, estamos inserindo a opção para as marcas adicionarem um parâmetro de referência aos links ig.me para criar experiências de mensagens personalizadas.
Novo fluxo de integração da API do InstagramEstamos anunciando um novo fluxo de integração beta para a API do Instagram. Os desenvolvedores podem se cadastrar na lista de interessados na versão beta até 29 de junho.
Lançamos o menu persistente do serviço da Messenger API for Instagram. Isso permite que os usuários descubram e interajam com os principais recursos da Página.
Como anunciado em 14 de setembro de 2021, todas as Páginas do Facebook serão compatíveis com o novo comportamento do protocolo de entrega. Todas as Páginas devem finalizar a migração até 18 de março de 2022. Consulte a seção sobre alterações disruptivas para saber mais. Este é um resumo das principais melhorias anunciadas anteriormente.
Estamos fazendo melhorias no protocolo de entrega que ajuda desenvolvedores e empresas a lançar experiências de mensagem (como apps) com agilidade, facilita a transferência de controle de conversas entre apps e garante uma ótima experiência do usuário ao impedir que apps interceptem conversas em andamento. As principais melhorias são: o modo exclusivo, o modo ocioso, as novas APIs para maior controle sobre a propriedade de conversas e a remoção da necessidade de atribuir funções primárias ou secundárias a apps.
Lançamos as configurações de personalização dos pontos de entrada do plugin de bate-papo pela API, além da nossa ferramenta de configuração interna. Isso permitirá que as empresas escolham o ícone e a etiqueta do ponto de entrada mais adequados para a marca, a partir de um conjunto de opções predefinidas. Para saber mais, consulte a documentação para desenvolvedores.
A Messenger API for Instagram agora está disponível para contas de criador de conteúdo da plataforma que têm menos de 500 mil seguidores. Para mais detalhes, consulte a documentação para desenvolvedores.
https://ig.me/m/{ig_profile_handle}
em sites, emails e muito mais. Para mais detalhes, consulte a documentação para desenvolvedores.Melhorias no protocolo de entrega
API de Rótulos Personalizados: estamos fazendo atualizações interessantes à API de Rótulos Personalizados, que permitem às empresas criar, atualizar e excluir rótulos, além de sincronizá-los entre a Caixa de Entrada da Página do Facebook e a ferramenta usada para se comunicar com os clientes.
name
da Graph API v12.0
e versões posteriores e da API de Rótulos Personalizados será substituído por page_label_name
. A partir de 14 de dezembro de 2021, as alterações entrarão em vigor para todas as versões mais antigas da Graph API. O page_label_name
pode ser usado em várias chamadas de API CRUD (criar, recuperar, atualizar, excluir) e webhooks.Messenger API Updates for Europe and Japan: restauramos o modelo de feedback do cliente na Messenger API que não estava disponível para empresas na Europa nem para pessoas na Europa e no Japão que se conectam a organizações de todo o mundo. Saiba mais aqui.
Atualizações da Messenger API for Instagram
Webhook de reação: atualizamos as reações de emoji para retornar um formato de Unicode novo e aceitar várias reações de emoji. Para migrar para a nova versão antes de 14 de dezembro de 2021 e continuar aceitando reações de emoji, consulte a documentação para desenvolvedores.
API do perfil do usuário: atualizamos a API do perfil do usuário para incluir campos adicionais que estão disponíveis publicamente no app Instagram. Para saber mais, consulte a documentação para desenvolvedores.
Descontinuação do IGID: a API de Conversas não retornará o campo IGID
e dependerá totalmente do campo IGSID
. Para saber mais sobre como migrar antes de 14 de dezembro de 2021, consulte a documentação para desenvolvedores.
API de Personalização do Plugin de Bate-papo do Facebook: lançamos as configurações de personalização do plugin de bate-papo por meio da API. Com esse lançamento, os desenvolvedores poderão editar recursos como posição, cor, saudação, configurações do modo convidado etc. que atualmente só estão disponíveis por meio das nossas ferramentas originais.
O webhook de eco de mensagem não incluirá o ID do app na Caixa de Entrada da Página do Facebook como parte da Graph API v12.0
: quando uma empresa responde a uma conversa do Messenger da Caixa de Entrada da Página do Facebook, outros apps conectados à Página têm acesso ao webhook de eco de mensagem. Esses apps receberão um webhook de eco com o ID do app da Caixa de Entrada da Página do Facebook (263902037430900
).
As seguintes alterações se aplicam à versão 11.0 e posteriores.
Inclusão de <mid>
em eventos messaging_postback
do Messenger e da Messenger API for Instagram na versão 11.0 e posteriores da Graph API: estamos adicionando o campo de identificação da mensagem (<mid>
) como parte da carga messaging_postback
, a fim de reduzir os gastos de engenharia dos parceiros que dependem da API de Conversas para buscar o histórico de conversas e compará-lo aos eventos do webhook. Veja mais detalhes aqui.
Os modelos para companhias aéreas se tornaram obsoletos: a partir da versão 11 da Graph API, os modelos para companhias aéreas não serão mais aceitos. A descontinuação em versões anteriores da Graph API acontecerá seis meses após o anúncio dessa alteração, em 6 de dezembro de 2021. Recomendamos que as companhias aéreas enviem modelos de cartão de embarque e de check-in no formato de imagem, consistente com o modo de envio usual dessas notificações em outros canais.
Messenger API for Instagram: disponibilizamos a API a todos os desenvolvedores que permitem que as marcas ofereçam experiências de troca de mensagens em escala no Instagram. Agora os desenvolvedores podem adicionar as mensagens do Instagram aos próprios apps e criar experiências de mensagens na plataforma. Também é possível ajudar empresas a usar diferentes apps para aproveitar fluxos de trabalho existentes, gerar conversas mais significativas, aumentar a satisfação dos clientes e impulsionar as vendas. Saiba mais aqui. O uso da Messenger API for Instagram deve atender às Políticas do Desenvolvedor, em especial as listadas na seção "APIs de mensagens do Messenger e do Instagram", além da documentação técnica.
Agora a tag de mensagem de Human Agent está disponível a todos os desenvolvedores. Com ela, as empresas podem responder manualmente às mensagens dos usuários no Messenger e no Instagram fora da janela-padrão de mensagens de 24 horas por até 7 dias. A tag é muito útil para certos casos de uso, como fechamentos no fim de semana ou questões que requerem mais de 24 horas para resolver. Os desenvolvedores precisarão solicitar a permissão da tag de Human Agent no Painel de Apps mesmo se o app já tiver autorização para usar a tag de mensagem de Human Agent. Vá até a seção "Permissões e recursos" do Painel de Apps e solicite a permissão "Human Agent". Saiba mais aqui.
Está disponível a versão beta do modelo de feedback do cliente: estamos lançando um modelo nativo no Messenger compatível com formatos comuns de pesquisa, como Customer Satisfaction (CSAT), Net Promoter Score (NPS), Customer Effort Score (CES) e texto livre. O modelo nativo é fácil de integrar, pois foi criado na Send API e elimina a necessidade de gerar soluções de pesquisa personalizada com o webView. Além disso, ele simplifica a soma de pontuações entre canais que usam formatos de pesquisa parecidos. Saiba mais aqui.