> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/instagram-components/enviar-opt-in.md).

# 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.<br>
* **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.<br>
* **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.<br>

### 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.<br>
* **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).<br>

### 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.<br>
* **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.<br>

### 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                                      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/instagram-components/enviar-opt-in.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.