Comece gerando o Segredo do Aplicativo e o token de Acesso à Página no Facebook Messenger.

1. Faça log-in na sua conta do desenvolvedor do Facebook.

2. Crie uma página do Facebook que hospede seu bot. A descrição, as imagens e a primeira página que você adicionar à página identificarão seu bot para seus usuários.

3. Em seguida, crie o aplicativo do Facebook que você vinculará a essa página. Como esse é um aplicativo do Messenger, escolha Aplicativos para Messenger e, em seguida, clique em Criar ID do Aplicativo.
   
   Descrição da configuração da ilustração-fbapp.png
   

   Se você não tiver escolhido a opção Aplicativos para Messenger nessa caixa de diálogo (por exemplo, se você estiver criando um aplicativo de teste), clique em Adicionar Produto na barra de navegação esquerda, escolha Mensageiro na página Configuração do Produto e clique em Conceitos Básicos.
   
   Descrição da ilustração add-product.png
   

4. Na página Painel de Controle do aplicativo do Facebook, copie o segredo do aplicativo e cole em algum lugar conveniente no seu sistema.
   
   Descrição da ilustração facebook-dashboard.png
   

   Você precisará do segredo do aplicativo para concluir a configuração do seu canal do Facebook.

5. No Painel de Controle do seu aplicativo, gere o Token de Acesso à Página selecionando sua página do Facebook.
   
   Descrição da ilustração page-access-token.png
   

6. Copie o token de acesso e cole-o em algum lugar conveniente.

   Você usará esse token, que dá ao seu Aplicativo do Facebook acesso à API de Mensagens do Facebook, para concluir sua definição de canal no Digital Assistant.

Com a configuração concluída, você está pronto para ativar o canal do Facebook.

• No Digital Assistant, selecione o canal e ative o controle Canal Ativado.
• Clique em e selecione o assistente digital ou a habilidade que deseja associar ao canal.

Agora você pode testar o bot pelo canal.

Concluída a configuração de mensagens e do Canal do Facebook, você pode testar seu bot usando sua página do Facebook, o Facebook Messenger (https://www.messenger.com/) e o aplicativo do Facebook Messenger no seu telefone (). Depois de localizar seu bot na pesquisa, você está pronto para começar a bater papo com ele. Você pode ver as alterações que faz no fluxo de diálogo em tempo real.

Descrição da ilustração test-bot.png

O Facebook Messenger permite que você crie um menu persistente ao lado do campo Mensagem. Consulte https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu/ para obter detalhes sobre o recurso.

Este é um exemplo que mostra itens do menu persistente para "Order Pizza" e "Order Pasta":

Descrição da ilustração persistente-menu.jpg

Os canais do Facebook Messenger no Digital Assistant suportam as seguintes capacidades:

• texto (envio e recebimento)
• imagens (envio e recebimento)
• arquivos (envio e recebimento)
• emojis (envio e recebimento)
• localização, mas obsoleto (envio e recebimento)
• links
• postbacks
• solicitações de localização
• propriedades personalizadas
• componentes de carrossel
• componentes de lista

Se você estiver direcionando sua habilidade para vários canais com diferentes recursos de formatação e sintaxe, poderá usar a marcação HTML básica em suas mensagens. Se você fizer isso, essa marcação será automaticamente convertida para o formato de markdown do Facebook Messenger quando a mensagem for transmitida para o canal. Isso é particularmente útil se você estiver direcionando suas habilidades para outros canais, além do Facebook Messenger. Consulte Formatação de Rich Text em Canais.

Os canais do Facebook Messenger no Digital Assistant têm as seguintes restrições de mensagens:

• Mensagens de Texto
  • Tamanho máximo da mensagem de texto: 640 caracteres. Se o tamanho exceder 640, o texto será dividido em várias mensagens.
  • Tamanho máximo do label de ação do texto: 20 caracteres
  • Tipos de ações de texto permitidos: Postback, Chamada, URL
  • Número máximo de ações de texto: 3. Se houver mais ações de texto, a mensagem será convertida em vários cartões horizontais, com o mesmo texto usado como título de cada cartão, cada um contendo até 3 ações.
• Cartões Horizontais
  • Tamanho máximo do título: 80 caracteres
  • Tamanho máximo da descrição: 80 caracteres
  • Tamanho máximo do label de ação do cartão: 20 caracteres
  • Número máximo de cartões: 10
  • Número máximo de ações do cartão: 3. Se o número de ações do cartão passar de 3, o cartão será duplicado para renderizar o restante das ações.
  • Número mínimo de ações do cartão: 0.
  • Número máximo de ações da lista de cartões: 0
  • Pelo menos uma descrição, imagem ou ação é necessária?: Sim
  • Tipos de ações de cartão permitidas: Postback, Chamada, URL, Compartilhamento
  • Tipos de ações de lista de cartões permitidos: N/A
• Cartões Verticais
  • Não suportado
• Mensagens de Anexo
  • Suportado?: Sim
  • Ações de anexo permitidas?: Não
• Botões de Ação
  • Tamanho máximo do label de ação global: 20 caracteres
  • Número máximo de ações globais: 11
  • Tipos de ações globais permitidas: Postback

Para canais do Facebook Messenger, você pode estender a funcionalidade dos componentes de Resposta Comum com recursos específicos do Facebook.

Acesse as extensões usando o elemento channelCustomProperties nos metadados do componente Resposta Comum e definindo as propriedades apropriadas. O código tem o seguinte formato:

...
            channelCustomProperties:
            - channel: "facebook"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Estas são as propriedades personalizadas disponíveis para canais do Facebook Messenger:

Veja um exemplo de propriedades personalizadas definidas no nível do item de resposta (top_element_style) e no nível de cartões (webview_height_ratio e fallback_url):

responseItems:
  - type: "cards"
    cardLayout: "vertical"
    cards:
      - title: "${pizzas.name}"
        description: "${pizzas.description}"
        imageUrl: "${pizzas.image}"
        url: "${pizzas.moreInfo}"
        iteratorVariable: "pizzas"
        channelCustomProperties:
          - channel: "facebook"
            properties:
              webview_height_ratio: "compact"
              fallback_url: "http://www.oracle.com"
    channelCustomProperties:
      - channel: "facebook"
        properties:
          top_element_style: "large"
...

Para obter informações gerais adicionais sobre channelCustomProperties, consulte Extensões Específicas do Canal.