Tela de boas-vindas

Este documento mostra como criar uma tela de boas-vindas para sua experiência do Messenger. A tela de boas-vindas exibe o nome da Página do Facebook da sua empresa, a foto do perfil e a foto da capa da sua Página do Facebook, além do tempo que normalmente sua empresa leva para responder às mensagens, uma mensagem de saudação opcional e um botão Começar. Quando uma pessoa clica nesse botão, uma mensagem Começar é publicada na conversa, e o app pode enviar mensagens a ela.

Como funciona

Quando uma pessoa clica no botão Começar na sua experiência do Messenger, uma notificação de webhook é enviada a você. Você pode usar essa notificação para enviar uma mensagem inicial de boas-vindas, como um texto ou um conjunto de respostas rápidas.

Antes de começar

Este guia considera que você leu o artigo Overview for the Messenger Platform, implementou os componentes necessários (como uma Página do Facebook da empresa ou uma página de teste), registrou-se como desenvolvedor da Meta e criou um ID do app de negócios da Meta com o produto Messenger.

Você precisará:

Um token de acesso à Página solicitado de uma pessoa que pode executar a tarefa MESSAGING na Página.
A permissão pages_messaging.
A assinatura do evento de webhook messaging_postbacks.

Limitações

Para apps com acesso padrão, a tela de boas-vindas ficará visível apenas para pessoas que tenham uma função no app.

Comandos

Caso sua Página use comandos, a tela de boas-vindas mostrará a lista de comandos compatíveis com a experiência de mensagens para que as pessoas possam entender melhor quais ações é possível solicitar ao Messenger.

Implementar o botão Começar

Para definir a carga de postback, envie uma solicitação POST à API do perfil do Messenger:

curl -X POST -H "Content-Type: application/json" -d '{
  "get_started": {"payload": "

Para ver todos os detalhes, consulte a referência da propriedade get_started.

Boas práticas

Comunique as próximas etapas para incentivar uma resposta na sua mensagem de boas-vindas. Você pode usar botões para adicionar estrutura à mensagem e destacar ações específicas que as pessoas podem realizar.
Compartilhe comandos básicos na sua mensagem de boas-vindas. Para que as pessoas encontrem o que desejam mais rapidamente, informe quais palavras-chave ou termos elas podem usar para pedir ajuda, obter atualizações, entre outras opções.
Modifique sua experiência de integração quando o bot for alterado. Revise o texto de saudação e a mensagem de boas-vindas ao atualizar seus recursos para garantir que o conteúdo ainda seja relevante.
Lembre-se de que tudo na tela funciona em conjunto. O contexto fornecido na sua saudação do Messenger deve complementar o botão Começar.
Não exiba mensagens genéricas demais. Tente chamar as pessoas pelo nome para tornar a mensagem pessoal e entenda que essa é uma oportunidade de mostrar como usar e controlar a experiência.

Configurar o texto de saudação

O texto de saudação na tela de boas-vindas é a primeira oportunidade de você dizer a uma pessoa por que ela deve iniciar uma conversa com seu bot do Messenger. No texto de saudação, você pode incluir uma descrição do que seu bot faz, como os principais recursos, ou um slogan. Esse também é um ótimo espaço para começar a definir o estilo e o tom do seu bot.

É possível exibir textos de saudação-padrão e localizados.

Para configurar o texto de saudação, envie uma solicitação POST à API do perfil do Messenger:

curl -X POST -H "Content-Type: application/json" -d '{
  "greeting": [
    {
      "locale":"default",
      "text":"Hello!" 
    }, {
      "locale":"en_US",
      "text":"Timeless apparel for the masses."
    }
  ]
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=

Para ver todos os detalhes, consulte a referência da greeting property.

Personalização

Você pode personalizar o texto de saudação usando o nome da pessoa. Você pode usar os seguintes segmentos de modelo:

{{user_first_name}}
{{user_last_name}}
{{user_full_name}}

Exemplo

"greeting":[
  {
    "locale":"default",
    "text":"Hello {{user_first_name}}!"
  }
]

Boas práticas

Trate a saudação como uma introdução e um resumo da sua experiência. As saudações podem ter no máximo 160 caracteres. Por isso, seja breve.
Informe a funcionalidade principal da sua experiência. O contexto ajuda as pessoas a entender como interagir com você e define as expectativas sobre os recursos oferecidos.
Não aja como se a saudação fosse um manual de instruções. Como a saudação desaparece da tela, use suas mensagens para apresentar funcionalidades e comandos específicos.
Não use formatação de texto em excesso (como espaçamento, pontuação ou quebras de linha) na saudação para aproveitar ao máximo o limite de caracteres.

Veja também

https://developers.facebook.com/docs/graph-api/reference/v14.0/page/messenger_profile