Tags de mensagem

As tags de mensagem permitem o envio individualizado de atualizações importantes e específicas aos usuários fora da janela de mensagens-padrão.

Recomendamos que as empresas respondam às mensagens dos usuários em até 24 horas. As tags de mensagem permitem o envio individualizado de atualizações importantes e específicas aos usuários fora da janela de mensagens-padrão. As empresas podem enviar conteúdo promocional por meio das mensagens-padrão. As empresas que usam a plataforma do Messenger também podem enviar conteúdo promocional por meio das mensagens patrocinadas.

As tags de mensagem não podem ser usadas para enviar conteúdo promocional, incluindo promoções, ofertas, cupons e descontos, entre outros. O uso das tags de mensagem fora dos casos aprovados abaixo poderá resultar em restrições à capacidade da Página ou da conta do Instagram de enviar mensagens. Consulte a Política da Plataforma do Messenger e da API de Mensagens do Instagram para mais detalhes.

Para enviar uma mensagem promocional a diversas pessoas fora da janela de mensagens-padrão, as empresas que usam a plataforma do Messenger deverão optar pelas mensagens patrocinadas. Esse tipo de mensagem permite o envio de mensagens direcionadas para retomar as conversas com pessoas que têm um bate-papo aberto com a empresa. Veja mais informações na documentação sobre mensagens patrocinadas. Para casos de uso na plataforma do Messenger, como alertas sobre produtos que voltaram ao estoque, liquidações-relâmpago, avisos sobre a diminuição de preços e assim por diante, recomendamos usar a API de Notificação Única da plataforma. Consulte a documentação sobre notificação única para saber mais. Observe que as mensagens patrocinadas e as notificações únicas não estão disponíveis para a API de Mensagens do Instagram.

Conteúdo

Tipos de tag de mensagem

Tag Descrição Usos permitidos Usos não permitidos (lista não exaustiva)

CONFIRMED_EVENT_UPDATE
(indisponível para a API de Mensagens do Instagram)

Envie lembretes ou atualizações sobre um evento no qual o usuário se inscreveu (por exemplo, confirmou presença ou comprou ingresso). Essa tag pode ser usada para os próximos eventos ou os que estiverem em andamento.

  • Lembrete sobre as próximas aulas, compromissos ou eventos agendados do usuário
  • Confirmação da reserva ou da participação do usuário em um evento ou compromisso aceito
  • Notificação sobre o agendamento do transporte ou da viagem do usuário, por exemplo, data de chegada, cancelamentos, atraso com a bagagem ou outras mudanças de status
  • Conteúdo promocional, incluindo promoções, ofertas, cupons e descontos, entre outros
  • Conteúdo relacionado a eventos nos quais o usuário não está inscrito (por exemplo, lembretes sobre a compra de ingressos para eventos, venda cruzada de outros eventos, cronogramas de viagem etc.)
  • Mensagens relativas a eventos anteriores
  • Comandos interativos para pesquisas, enquetes ou avaliações que não se relacionem a uma interação prévia no Messenger

POST_PURCHASE_UPDATE
(indisponível para a API de Mensagens do Instagram)

Informe o usuário sobre uma atualização relativa a uma compra recente.

  • Confirmação de uma transação, como faturas ou recibos
  • Notificações sobre o status do envio, por exemplo, produto em trânsito, enviado, entregue ou atrasado
  • Alterações relacionadas a um pedido do usuário, por exemplo, cartão de crédito recusado, itens fora de estoque ou outras questões que exigem uma ação do usuário
  • Conteúdo promocional, incluindo promoções, ofertas, cupons e descontos, entre outros
  • Mensagens de venda cruzada ou upsell de produtos ou serviços
  • Comandos interativos para pesquisas, enquetes ou avaliações que não se relacionem a uma interação prévia no Messenger

ACCOUNT_UPDATE
(indisponível para a API de Mensagens do Instagram)

Informe o usuário sobre uma alteração pontual na inscrição ou na conta dele.

  • Alteração no status da inscrição (por exemplo, cartão de crédito ou emprego)
  • Notificação relativa a atividades suspeitas, como alertas de fraude
  • Conteúdo promocional, incluindo promoções, ofertas, cupons e descontos, entre outros
  • Conteúdo recorrente (por exemplo, fatura pronta, pagamento pendente, novo classificado de emprego)
  • Comandos interativos para pesquisas, enquetes ou avaliações que não se relacionem a uma interação prévia no Messenger

HUMAN_AGENT**

Permite que agentes humanos respondam às consultas de usuários. A resposta pode ser enviada no máximo 7 dias depois da mensagem do usuário.

  • Suporte prestado por agentes humanos para resolver problemas que não podem ser solucionados dentro da janela de mensagens padrão (por exemplo, porque a empresa fecha no fim de semana ou porque a questão requer mais de 24 horas para ser resolvida)
  • Mensagens automáticas
  • Conteúdo não relacionado à consulta do usuário

CUSTOMER_FEEDBACK

(indisponível para a API de Mensagens do Instagram)

Essa tag permite enviar o modelo de feedback do cliente até sete dias após a última mensagem do usuário.

  • Pesquisas de feedback do suporte pós-compra
  • Pesquisas de feedback pós-evento
  • Avaliações de produto

** Os aplicativos precisam se inscrever para obter a permissão Human Agent pelo Painel de Aplicativos do desenvolvedor. Vá até Painel de Aplicativos -> Análise do aplicativo -> Permissões e recursos -> Human Agent. Os aplicativos que já têm aprovação para o acesso beta à permissão Human Agent não precisam se inscrever novamente.

A permissão Human Agent não está disponível no acesso padrão/modo de desenvolvimento. Será preciso concluir o processo de análise do aplicativo antes de utilizar a marcação de agente humano. Ao enviar o aplicativo para análise, forneça instruções claras e uma demonstração de como você pretende utilizar a marcação de agente humano em suas experiências.

Como enviar mensagens com tags

Para mandar uma mensagem com tag por meio da API de Envio, envie uma mensagem normalmente, mas com a propriedade tag anexada ao corpo da solicitação POST:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": { 
    "id": "<PSID>"
  },
  "message":{
    ...
  },
  "messaging_type": "MESSAGE_TAG",
  "tag": "ACCOUNT_UPDATE"
      
}' "https://graph.facebook.com/v12.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"  
    

For a complete list of API calls and request properties, see the Send API Reference.