You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Classifique esta página:

Twilio Channels: Facebook Messenger

Versão beta pública

O Facebook Messenger está atualmente disponível como um produto beta público. Isso significa que alguns recursos ainda não foram implementados e outros podem ser alterados antes que o produto seja declarado como disponível em geral.

Os produtos beta públicos não são cobertos por um SLA da Twilio.

O Channels é uma coleção de integrações de terceiros que permitem enviar e receber mensagens em vários canais com as APIs da Twilio que você já usa. Atualmente, o Facebook Messenger (Beta) e o WhatsApp Business API são compatíveis. Você pode usar o Facebook Messenger pelo Twilio Programmable Messaging e o WhatsApp pelo Twilio Programmable Messaging e Conversations. Clique aqui para instalar o Facebook Messenger. Para o WhatsApp, saiba mais sobre o processo de integração ou comece agora com o Sandbox do WhatsApp.

Configurar o Facebook Messenger

Pré-requisitos

Para enviar e receber mensagens do Facebook Messenger, você deve ter:

  • Uma Página do Facebook configurada para sua empresa: Esta é a identidade que será usada para receber e responder mensagens no Facebook Messenger. Se você ainda não tiver uma página do Facebook, poderá criar uma criando um login em sua conta do Facebook, ao clicar em Pages (Páginas) e criando uma nova página.
  • Uma conta pessoal do Facebook: Sua conta do Facebook deve ter acesso de administrador à página do Facebook.

1. Concorde com os Termos e instale o Facebook Messenger

Todas as etapas a seguir são executadas por meio do Console da Twilio. No ecossistema de mensagens do Facebook, os usuários se comunicam com marcas e empresas enviando mensagens para a página do Facebook. A Twilio cria um Remetente para cada página do Facebook que você deseja usar para mensagens. O Remetente é a identidade usada no campo "From" (De) para enviar mensagens aos usuários.

Para começar, primeiro vá para a área Channels (Canais) no Console da Twilio, clique em Facebook Messenger e instale-o.

2. Autorizar a Twilio a enviar mensagens em seu nome

Em seguida, navegue até o canal do Facebook Messenger que acabou de ser instalado e clique no botão "Connect with Facebook" (Conectar com o Facebook). Siga as instruções para selecionar as páginas do Facebook que você deseja autorizar a configurar como remetentes. Nesta etapa, você autorizará o aplicativo Facebook da Twilio a enviar e receber mensagens em nome de suas páginas do Facebook, permitindo assim o acesso ao Facebook Messenger por meio da API do Twilio Programmable Messaging.

Observação: Você não precisa configurar seu próprio aplicativo do Facebook, pois a Twilio cuida disso para você.

3. Configure uma página do Facebook para usar como Remetente

Em seguida, vamos configurar a página do Facebook que você deseja usar como remetente. Enquanto estiver na página Catálogo da Twilio Channels:

  • No cabeçalho "Properties" (Propriedades) no campo de entrada Unique Name (Nome exclusivo), insira um nome de sua escolha para a página (Opcional).
  • Sob o cabeçalho "Credentials" (Credenciais), clique no menu suspenso Select a Page (Selecionar uma página) e selecione uma única página do Facebook para usar como remetente.
  • No cabeçalho "Configuration" (Configuração) no campo de entrada Callback URL (URL de retorno de chamada), insira uma URL do webhook onde você pode receber mensagens enviadas para a página do Facebook de seus usuários finais.

Por fim, clique no botão "Save" (Salvar). Isso cria uma instância da página do Facebook que agora você pode usar como Remetente.

Opcional: Configurar campos adicionais

Depois que um canal for autenticado, você poderá configurá-lo para funcionar com uma API da Twilio :

Parâmetro de configuração Descrição
Nome fácil da página Nome da página do Facebook. O nome não pode ser alterado.
URL de retorno de chamada Um URL em que a Twilio POST (PUBLICARÁ) sempre que uma mensagem for recebida pela Twilio. O formato desta solicitação é o mesmo que Inbound SMS TwiML Request.da Twilio. URLs não relacionadas devem conter um nome de host válido (sublinhados não são permitidos).
Método de retorno de chamada Método Http que será com a URL de retorno de chamada. GET ou POST.
URL de fallback URL de fallback que a Twilio chama se a URL de retorno de chamada acima retornar um erro.
Método de Fallback Método HTTP para usar com a URL de Fallback. GET ou POST.e ID
URL de retorno de chamada de status Uma URL que a Twilio chama cada vez que o status da mensagem de saída mudar para um dos seguintes: failed, sent. A Twilio PUBLICARÁ o standard TwiML request parameters, bem como standard Status parameters : MessageStatus e ErrorCode.
URLs não relacionados devem conter um nome de host válido (sublinhados não são permitidos).
Método de retorno de chamada de status Método Http que será usado com retorno de chamada de status. GET ou POST.

Configuração de vários Remetentes

A Twilio é compatível com a criação de várias instâncias para que seu aplicativo possa oferecer suporte a diferentes páginas do Facebook. Se desejar configurar mais de uma página do Facebook como remetente, clique em"Add Another Instance" (Adicionar outra instância) e repita as etapas acima para cada nova página do Facebook.

Para fornecedores independentes de software (ISVs) e integradores de software (SIS) que gerenciam as comunicações do Facebook Messenger em nome de seus clientes, você precisa ter acesso de administrador a cada página do Facebook.

Observação: Se você for um ISV ou SI gerenciando várias páginas em nome de muitas marcas, recomendamos o uso de subcontas para cada marca. Para obter mais informações sobre o uso de subcontas, consulte o artigo de suporte Introdução aos projetos e subcontas da Twilio.

Usar o Facebook Messenger

O Facebook Messenger é um canal iniciado pelo usuário

Agora que o Remetente do Facebook Messenger está configurado, você precisa receber uma mensagem de um usuário final para responder. Os usuários do Facebook precisam iniciar um contato com você enviando uma mensagem para sua página do Facebook antes de entrar em contato com eles. Quando a mensagem de um usuário for recebida, você poderá responder ao usuário por 24 horas. Para obter mais detalhes, consulte Visão geral da política de plataforma (Facebook para desenvolvedores).

Observação: Você deve receber uma mensagem de um usuário final para poder responder. O Facebook Messenger não é um canal de notificação.

Dica: Você pode enviar a si mesmo uma mensagem usando m.me/<page id>. Esta é a maneira mais fácil de testar seu remetente.

A Twilio marca as mensagens com "ACCOUNT_UPDATE" se enviadas após a sessão de 24 horas.

Recuperar o ID de usuário do Messenger a partir do retorno de chamada

Quando um usuário envia uma mensagem para sua página do Facebook, a URL de retorno de chamada recebe a mensagem com os mesmos parâmetros de um WhatsApp da Twilio padrão ou mensagem SMS. O remetente e os destinatários do Facebook Messenger têm o formato messenger:{messenger id}. Você precisará recuperar o ID de usuário do Facebook Messenger da resposta de retorno de chamada.

Responder usando a API Programmable Messaging

Para enviar uma mensagem do Facebook, faça uma solicitação HTTP POST para o recurso da API REST do Programmable Messaging da Twilio com três informações necessárias:

  • Um destinatário.
  • Um remetente.
  • Corpo da mensagem.

Consulte API REST: Como enviar um SMS ou MMS ou API REST: página Messages para obter detalhes.

        
        
        

        Gerenciar seus remetentes do Facebook

        Opt-ins e Opt-outs (inscrições e cancelamentos)

        Você também é responsável por gerenciar as opções de opt-ins (inscrições) e opt-outs (cancelamentos) do consumidor às plataformas do Facebook Messenger. Os usuários concedem a você permissão para enviar mensagens a eles por meio do início da conversa com sua página do Facebook. Quando os usuários solicitam que você interrompa as mensagens, você deve interrompê-las. Os usuários também têm a opção de impedir que a página entre em contato com eles novamente.

        Manter a alta qualidade

        Uma empresa deve aderir estritamente às políticas comerciais e de negócios do Facebook e também deve oferecer experiências de alta qualidade no Messenger. Durante ou após a interação no Messenger, os usuários podem fornecer feedback negativo ao Facebook quando as conversas de uma página são consideradas spam, abusivas ou desagradáveis. É recomendável que você mantenha conversas de alta qualidade e valor agregado alinhadas com a intenção do usuário de se envolver com você. Se uma empresa mostrar um padrão de violação das políticas do Facebook, o Facebook desativará a página usando o Facebook Messenger.

        Classifique esta página:

        Precisa de ajuda?

        Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

              
              
              

              Obrigado pelo seu feedback!

              Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

              Enviando seu feedback...
              🎉 Obrigado pelo seu feedback!
              Algo deu errado. Tente novamente.

              Obrigado pelo seu feedback!

              thanks-feedback-gif