> ## Documentation Index > Fetch the complete documentation index at: https://docs.airys.chat/llms.txt > Use this file to discover all available pages before exploring further. # Revisão do Aplicativo do Instagram > Guia completo para enviar uma solicitação de Revisão de Aplicativo do Instagram para obter permissões avançadas de mensagens para a integração do AirysChat Este documento fornece um modelo personalizável para marcas que solicitam permissões avançadas do Instagram. Use este modelo para enviar uma solicitação de Revisão de Aplicativo do Instagram e demonstrar como seu aplicativo usa permissões avançadas de mensagens para fornecer suporte ao cliente em tempo real pelo Instagram. ## Permissões Solicitadas * `instagram_business_basic` – Recuperar metadados da conta conectada do Instagram Business (nome de usuário, ID, foto do perfil). * `instagram_business_manage_messages` – Receber e responder a mensagens diretas. * `human_agent` – Permitir respostas humanas além da janela padrão de 24 horas. Por favor, substitua todos os valores de espaço reservado, como `BRAND_NAME`, `DASHBOARD_URL`, `EMAIL` e `PASSWORD` antes de enviar. ## Iniciar o Processo de Revisão ### Adicionar a Plataforma do Site Navegue até as configurações básicas e adicione a plataforma do Site. Forneça o URL do seu frontend na configuração da plataforma. Add platform ### Ir para a Seção de Revisão de Aplicativo Vá para o produto do Instagram e clique em "Go to App Review" (Ir para a Revisão de Aplicativo). Go to App Review ### Confirmar a Documentação Clique em "Continue" para confirmar a documentação. Confirm documentation ### Selecionar as Permissões Selecione as permissões `instagram_business_basic`, `instagram_business_manage_messages` e `human_agent` e clique em "Continue to App Review" (Continuar para a Revisão de Aplicativo). Select permissions ### Configurar Solicitações de Revisão de Aplicativo Depois de clicar em "Continue to App Review" (Continuar para a Revisão de Aplicativo), você será redirecionado para a página de solicitações de Revisão de Aplicativo. App Review requests Clique no botão "Edit" (Editar) para editar a solicitação de revisão. Edit review request ### Conta Comercial Você **deve** ter uma Conta Comercial (Business Account) para poder solicitar essas permissões. Certifique-se de ter uma Conta Comercial antes de solicitar as permissões. Envie os detalhes da Conta Comercial. Business Account details ### Manipulação de Dados Por favor, responda a todas as perguntas na seção de Manipulação de Dados (Data Handling) e inclua todas as etapas de pré-processamento que você realiza nos dados. Data handling questions Data handling ### Concluir as Configurações do Aplicativo Certifique-se de ter um ícone de aplicativo, URL da política de privacidade e categoria de aplicativo configurados. Você pode atualizá-los por meio das Configurações Básicas (Basic Settings). App settings ### Instruções de Revisão Forneça as instruções de revisão ao revisor para a Revisão do Aplicativo. Essencialmente, você precisa fornecer as etapas para fazer login no Painel (Dashboard) e enviar uma mensagem para a conta conectada do Instagram. Review instructions Você pode usar o seguinte modelo para fornecer as instruções de revisão: 1. Vá para `[DASHBOARD_URL]`. 2. Faça login usando as seguintes credenciais. Certifique-se de que as credenciais sejam inseridas exatamente como fornecidas, sem espaços à esquerda ou à direita.\ Email: `[EMAIL]`\ Senha: `[PASSWORD]` 3. Depois de fazer login, você verá o Painel com uma tela de chat vazia. Na barra lateral mais à esquerda, você encontrará as Configurações (ícone de engrenagem). 4. Clique em Settings > Inboxes > Add Inbox. Você também pode acessar a página de configurações em: `[DASHBOARD_URL]/app/accounts/[ACCOUNT_ID]/settings/inboxes/new`. 5. Na primeira etapa, "Choose a channel" (Escolher um canal), selecione Instagram. Isso o levará à segunda etapa, onde você encontrará o botão "Continue with Instagram" (Continuar com o Instagram). 6. Assim que a configuração for concluída, você poderá enviar uma mensagem para a conta conectada do Instagram. 7. A mensagem deve aparecer no Painel em `[DASHBOARD_URL]/app/accounts/[ACCOUNT_ID]/dashboard`. Review instructions details ## Permissões Chegou a hora de solicitar as permissões. Clique em cada permissão e preencha os detalhes. Assim que terminar, clique em "Submit for Review" (Enviar para Revisão). Abaixo estão exemplos de solicitações de permissão que você pode usar como referência. Permission requests ## `instagram_business_basic` ### Por Que Você Está Solicitando Esta Permissão \[BRAND\_NAME] é uma plataforma de suporte ao cliente que permite que empresas gerenciem conversas em várias plataformas de mensagens — incluindo Instagram, WhatsApp, Facebook e muito mais — por meio de uma caixa de entrada unificada. Esta permissão é usada para: * Recuperar metadados básicos (nome de usuário, ID de usuário e foto de perfil) das contas conectadas do Instagram Business durante a integração. * Exibir informações do remetente (nome de usuário e ID) quando os clientes enviam mensagens para a empresa pelo Instagram. Esses metadados são essenciais para o roteamento correto das mensagens para o agente apropriado, identificação do agente que está lidando com a conversa e exibição precisa do perfil na interface do usuário do chat, garantindo uma experiência perfeita para o cliente. * **URL do Aplicativo:** \[DASHBOARD\_URL] * **Conta de Teste:** * Email: \[EMAIL] * Senha: \[PASSWORD] *** ### Demonstração em Vídeo (Screencast) Inclua um screencast demonstrando as seguintes etapas: 1. Faça login no aplicativo usando as credenciais fornecidas. 2. Navegue até o Painel (Dashboard). 3. Adicione uma nova caixa de entrada selecionando o Instagram como o canal. 4. Autentique uma conta do Instagram Business. 5. Mostre que a plataforma usa a permissão `instagram_business_basic` para exibir: * Nome de usuário do Instagram * ID do usuário * Foto do perfil 6. Simule o recebimento de uma mensagem e mostre como esses metadados aparecem na caixa de entrada. *** ## `instagram_business_manage_messages` ### Por Que Você Está Solicitando Esta Permissão \[BRAND\_NAME] é uma plataforma de suporte ao cliente que permite que empresas gerenciem conversas em várias plataformas de mensagens — incluindo Instagram, WhatsApp, Facebook e muito mais — por meio de uma caixa de entrada unificada. Esta permissão permite que a plataforma gerencie e responda a mensagens do Instagram em nome da conta conectada do Instagram Business. Ela é usada para: * Receber mensagens por meio do webhook do Instagram. * Exibir conversas na caixa de entrada do agente. * Permitir que agentes respondam de dentro da plataforma. * Manter conversas sincronizadas em tempo real. A configuração do webhook funciona definindo um endpoint de URL na plataforma para receber mensagens de entrada do Instagram. Quando uma mensagem é enviada para a conta conectada do Instagram Business, ela aciona um evento de webhook que entrega a mensagem ao endpoint especificado. O backend processa esta mensagem, a armazena no banco de dados e atualiza a caixa de entrada do agente em tempo real. Sem essa permissão, os usuários não poderiam se comunicar com seu público do Instagram por meio da plataforma de suporte. * **URL do Aplicativo:** \[DASHBOARD\_URL] * **Conta de Teste:** * Email: \[EMAIL] * Senha: \[PASSWORD] *** ### Demonstração em Vídeo (Screencast) Inclua um screencast demonstrando as seguintes etapas: 1. Faça login no Painel (Dashboard). 2. Conecte uma conta do Instagram Business conforme descrito na seção anterior. 3. A partir de outra conta de usuário do Instagram, envie uma mensagem direta para a empresa conectada. 4. Mostre que a mensagem aparece na interface de usuário da caixa de entrada. 5. Responda a partir da caixa de entrada. 6. Volte ao Instagram para mostrar que o usuário recebeu a resposta. 7. Demonstre a sincronização em tempo real. *** ## `human_agent` ### Por Que Você Está Solicitando Esta Permissão \[BRAND\_NAME] é uma plataforma de suporte ao cliente que permite que empresas gerenciem conversas em várias plataformas de mensagens — incluindo Instagram, WhatsApp, Facebook e muito mais — por meio de uma caixa de entrada unificada. Estamos solicitando a permissão Human Agent (Agente Humano) para permitir que os agentes de suporte acompanhem as conversas dos clientes além da janela de 24 horas, especialmente quando os clientes entram em contato fora do horário comercial ou durante o fim de semana. Exemplo de caso de uso: * Um cliente envia uma mensagem na sexta-feira à noite. * A empresa fecha aos fins de semana. * Na segunda-feira de manhã, o agente não pode responder porque a janela de 24 horas expirou. * Com a tag Human Agent, o agente agora pode acompanhar na segunda-feira de manhã e resolver a dúvida. Isso melhora a experiência do cliente e garante que mensagens críticas não fiquem sem solução devido a limitações de tempo. Esta permissão é essencial para permitir que agentes humanos continuem as conversas de maneira natural, respeitosa e solidária, sem forçar os clientes a enviarem mensagens novamente apenas para reabrir a janela. * **URL do Aplicativo:** \[DASHBOARD\_URL] * **Conta de Teste:** * Email: \[EMAIL] * Senha: \[PASSWORD] *** ### Demonstração em Vídeo (Screencast) Inclua um screencast demonstrando as seguintes etapas: 1. Faça login na plataforma. 2. Abra uma conversa existente do Instagram que seja **mais antiga que 24 horas**. 3. Tente responder à mensagem e explique como a atual política da Meta restringe a resposta. 4. Explique por que uma resposta ainda é necessária — por exemplo, o agente de suporte estava indisponível durante o fim de semana ou o problema exigia encaminhamento. 5. Descreva como a tag `human_agent` será usada para permitir a resposta dentro da janela estendida de 7 dias. ## Notas * Não inclua credenciais de conta do Instagram. * Compartilhe apenas credenciais de Painel de teste (recomenda-se acesso não super admin). * Certifique-se de que seu screencast mostre claramente a interface de usuário da plataforma e os fluxos de trabalho relevantes. * Mantenha o uso de sua permissão alinhado com a política da Meta para tags de mensagem e privacidade do usuário. * Fale em voz alta ou adicione legendas em seu vídeo para clareza do revisor. * O vídeo deve ser o mais detalhado possível. **Dica:** Use um gravador de tela que capture as interações do mouse, pop-ups e atividades do navegador para demonstrar claramente os fluxos de autenticação e as interações da caixa de entrada.