Plugin Enviar para o Messenger
Quando o 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 o 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 |
|---|---|---|
| Enum | 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