Plugin Enviar para o Messenger
A partir de 30 de setembro de 2024, este recurso não estará mais disponível. É possível continuar usando recursos como links m.me que redirecionam para uma pessoa, página ou conversa do Messenger.
Quando seu app do Facebook estiver no modo de desenvolvimento, os recursos do plugin e da API funcionarão apenas para administradores, desenvolvedores e testadores do app com uma sessão válida. Depois de aprovado e publicado, o app funcionará para o público em geral.
O plugin "Enviar para o Messenger" é usado para disparar um evento de autenticação para seu webhook. Você pode passar dados para saber qual usuário e transação estavam ligados ao evento de autenticação e vincular o usuário no seu back-end.
Quando uma pessoa clicar pela primeira vez nesse botão, uma janela pop-up será exibida.
Requisitos
SDK do Facebook para JavaScript
Para usar o plugin Enviar para o Messenger, você deve incluir o SDK do Facebook para JavaScript na página em que o plugin será renderizado.
Para ver instruções sobre como fazer isso, consulte o Início rápido: SDK do Facebook para JavaScript.
Configuração
<div class="fb-send-to-messenger"
messenger_app_id="<APP_ID>"
page_id="PAGE_ID"
data-ref="<PASS_THROUGH_PARAM>"
color="<blue | white>"
size="<standard | large | xlarge>">
</div>Para ver a descrição completa dos atributos disponíveis, consulte a referência do Plugin Enviar para o Messenger.
Assinatura de evento
Assine os eventos do plugin.
<script>
FB.Event.subscribe('send_to_messenger', function(e) {
// callback for events triggered by the plugin
});
</script>Campos de evento
| Nome do campo | Tipo | Descrição |
|---|---|---|
| Enumeração | Nome do evento. Os valores possíveis são |
| String | Contém o valor definido no parâmetro |
| Booliano | Indica se o evento aconteceu depois que o pop-up de confirmação foi confirmado. |
| Indefinido | Este campo não é utilizado. |
Evento de webhook
O plugin Enviar para o Messenger dispara o evento de webhook messaging_optins.
Personalizar o comportamento de login
Se o usuário não estiver conectado ao Facebook, o plugin será renderizado sem a exibição da sua identidade. Ao clicar no botão, o usuário será solicitado a fazer login.
Se você definir allow_login como false, o plugin não será renderizado para usuários não conectados.
O plugin será renderizado sem uma sessão do Facebook somente se o app tiver sido aprovado e publicado.
Opções de texto de CTA
O plugin Enviar para o Messenger também é compatível com o atributo cta_text. Isso permite que você escolha o texto do botão para o plugin em uma lista de strings predefinida. Quando o atributo cta_text for usado, a maioria dos usuários conectados precisará apenas clicar no próprio botão do plugin para aceitar, sem precisar confirmar novamente no pop-up, e o evento messaging_optins será entregue imediatamente.
Os seguintes valores são compatíveis com o atributo cta_text:
GET_THIS_IN_MESSENGERRECEIVE_THIS_IN_MESSENGERSEND_THIS_TO_MEGET_CUSTOMER_ASSISTANCEGET_CUSTOMER_SERVICEGET_SUPPORTLET_US_CHATSEND_ME_MESSAGESALERT_ME_IN_MESSENGERSEND_ME_UPDATESMESSAGE_MELET_ME_KNOWKEEP_ME_UPDATEDTELL_ME_MORESUBSCRIBE_IN_MESSENGERSUBSCRIBE_TO_UPDATESGET_MESSAGESSUBSCRIBEGET_STARTED_IN_MESSENGERLEARN_MORE_IN_MESSENGERGET_STARTED