For the complete documentation index, see llms.txt. This page is also available as Markdown.

Enviar Opt-in

Visão Geral

O Componente de Solicitação de Opt-in do Instagram (identificado no sistema pelo nome técnico instagram_opt_in) é um nó de ação focado em conformidade (compliance) e autorização de canais. Sua função principal é disparar um bloco de mensagem estruturado na DM do usuário, solicitando formalmente que ele autorize a empresa a enviar notificações e mensagens ativas futuras em seu perfil. Ele serve para mitigar riscos de bloqueio e garantir que a conta comercial esteja alinhada com as políticas de spam da Meta.

Parâmetros de Configuração

A parametrização do bloco define o escopo do consentimento e o destino da requisição:

  • Credencial: Menu suspenso utilizado para selecionar a conta do Instagram Business autenticada que enviará o card de opt-in.

  • Token da página (* Campo Obrigatório): O token de acesso ou identificador de segurança associado à página do Facebook conectada ao perfil do Instagram, necessário para autenticar a requisição de permissão no grafo da Meta.

  • ID do Instagram do usuário (* Campo Obrigatório): Campo de texto que recebe o identificador único numérico do cliente (geralmente mapeado via variável dinâmica como {{instagram_id}}) para quem a solicitação de consentimento será enviada.

Construtor Visual

A interface do construtor foi projetada para garantir o preenchimento dos parâmetros de segurança indispensáveis para a API:

  • Validação de Chaves de Segurança: A presença do asterisco (*) nos campos de Token da página e ID do Instagram do usuário impede que o nó seja salvo de forma incompleta, mitigando erros de envio rejeitados pela Meta por falta de autenticação de escopo.

  • Estrutura de Saídas Condicionais: No editor visual, o acoplamento deste componente costuma abrir portas físicas de ramificação baseadas na resposta imediata do cliente ou no sucesso do disparo do card de consentimento (ex: autorizou / recusou).

Operadores Especiais

As propriedades lógicas deste componente lidam com persistência de tokens, controle de políticas de privacidade e atualização de flags de perfil:

  • Injeção de Tags de Destinatário: O parâmetro ID do Instagram do usuário aceita tags em formato de chaves duplas {{...}}. Isso permite que o motor do fluxo capture dinamicamente o ID gerado no gatilho de entrada (seja um comentário ou uma mensagem direta) e direcione o card de opt-in exatamente para aquele usuário.

  • Modificação do Status de Consentimento no CRM: Quando o usuário clica no botão nativo de confirmação enviado por este bloco no Instagram, a API da Meta retorna um webhook de validação. O motor da plataforma intercepta esse sinal e altera automaticamente uma flag lógica no perfil do contato, autorizando o sistema a disparar fluxos informativos ou promocionais futuros para ele.

Exemplos Práticos

A tabela abaixo demonstra cenários práticos de como estruturar o uso do componente de opt-in ao longo da jornada do cliente:

Credencial Selecionada

ID do Usuário (Variável)

Token da Página

Objetivo do Disparo

Caso de Uso Prático

@marca_ficticia

{{instagram.id}}

{{page_token_global}}

Coleta de autorização pós-comentário.

O usuário comentou em um post. O bot inicia o papo na DM e a primeira ação é enviar o Opt-in para garantir que ele aceita receber novidades antes de enviar o link do produto.

@loja_ficticia

{{instagram.id}}

{{page_token_global}}

Renovação de janela de contato.

Ao final de um suporte técnico, o bot envia o card de opt-in perguntando se o usuário aceita receber alertas de promoções semanais diretamente na DM.

@marca_ficticia

{{instagram.id}}

{{page_token_global}}

Cadastro em lista de transmissão.

Fluxo focado em lançamentos de infoprodutos. O componente é usado para que o lead assine a lista de notificações de lives diretamente pel

Atualizado

Isto foi útil?