Este guia fornece instruções passo a passo para integrar a Instagram Direct API com o Sanoflow, além de explicar em detalhe os requisitos da Meta para seu uso.

Como Chegar Aqui

• Faça login na sua conta Sanoflow.

• No menu lateral, vá até Configurações > Integrações.

• Selecione a aba Adicionar canal dentro da seção Mensagens.

Passos para Adicionar o Instagram Direct API ao Sanoflow

1. Conta Profissional no Instagram

   • É necessário ter uma conta Business ou Creator.

2. Página do Facebook

   • Sua conta do Instagram deve estar vinculada a uma Página do Facebook.

3. Permissões de Administrador

   • Você precisa ter acesso de administrador à Página do Facebook vinculada ao Instagram.

4. Login no Sanoflow

   • No painel do Sanoflow, vá até Configurações > Integrações.

5. Selecionar Instagram API

   • Em Mensagens, localize Instagram e clique em Adicionar.

6. Autenticar com o Facebook

   • Você será redirecionado para a página de login do Facebook. Entre com suas credenciais.

7. Conceder Permissões

   • Escolha as contas do Instagram às quais o Sanoflow terá acesso:

     • Todas as contas atuais e futuras ou

     • Somente as contas atuais.

   • Clique em Continuar

8. Revisar Pedidos de Acesso

   • Revise as permissões solicitadas pelo Sanoflow, incluindo:

     • Acessar perfil e posts da conta do Instagram conectada.

     • Gerenciar e acessar mensagens do Instagram Direct.

     • Gerenciar configurações e webhooks da Página.

   • Clique em Salvar

9. Concluir a Configuração

   • Ao retornar ao Sanoflow, confirme a integração. Sua conta do Instagram estará conectada.

Requisitos da Meta para Integração com a API do Instagram

1. Requisitos de Conta

   • Conta Business ou Creator.

   • Vinculada a uma Página do Facebook.

2. Escopos de Permissão

   • instagram_manage_messages: gerenciar conversas.

   • instagram_basic: acessar dados de perfil.

   • pages_manage_metadata: gerenciar webhooks e metadados.

   • pages_read_engagement: visualizar métricas de engajamento.

3. Conformidade com Políticas

   • Respeitar as Políticas da Plataforma do Facebook e Instagram.

   • Garantir conformidade com requisitos de privacidade e segurança de dados.

4. Limitações de Mensagens

   • Limite de mensagens por usuário para evitar spam.

   • Respostas devem ser enviadas em até 24h para permanecer gratuitas.

5. Webhook

   • Deve ser configurado para atualizações em tempo real.

   • A URL precisa ser válida e segura.

6. Limites de API

   • O uso é limitado de acordo com a atividade da conta.

Boas Práticas no Uso do Instagram Direct API

1. Conceda todas as permissões solicitadas.

2. Use templates pré-aprovados para notificações e lembretes.

3. Mantenha engajamento ativo com respostas rápidas.

4. Monitore o uso da API para não ultrapassar limites.

5. Automatize tarefas repetitivas com cuidado.

6. Analise métricas de resposta e satisfação.

7. Conclua a verificação de negócios no Business Manager.

8. Treine sua equipe para usar a API de forma eficiente.

9. Revise regularmente permissões de acesso.

10. Respeite as políticas de mensagens da Meta.

Problemas Comuns e Soluções

1. Erro na Integração

   • Conta não é Business/Creator ou não está vinculada a Página.

2. Mensagens Não Enviadas/Recebidas

   • Verifique a conexão no Sanoflow e webhooks no Developer Dashboard.

3. Erros de Permissão

   • Reautorize e conceda todas as permissões necessárias.

4. Limite de taxa excedido

   • Reduza chamadas de API e volume de mensagens.

5. Conta do Instagram Não Aparece

   • Certifique-se de que está vinculada a uma Página do Facebook no mesmo Business Manager.

6. Notificações Atrasadas

   • Verifique se o webhook está ativo e configurado corretamente.

7. Problemas com Templates

   • Ajuste o conteúdo para seguir diretrizes da Meta e reenvie.

8. Verificação de Negócio Pendente

   • Complete no Business Manager para liberar recursos avançados.

9. Timeout de Integração

   • Verifique sua internet e tente novamente.

10. Erros Genéricos de API

    • Revise os logs no Developer Dashboard.

FAQs

1. O que é a Instagram Direct API?

   • É a API que permite integrar mensagens do Instagram ao Sanoflow para gerenciar interações com clientes.

2. Quais permissões são necessárias?

   • Mensagens, acesso a posts, configurações e webhooks.

3. Preciso de conta Business?

   • Sim, Business ou Creator vinculada a Página.

4. Posso conectar várias contas?

   • Sim, repetindo o processo para cada conta.

5. Quais mensagens posso gerenciar?

   • Direct messages, respostas a stories e dúvidas de clientes.

6. O uso é gratuito?

   • O API em si não tem custo, mas pode depender do plano do Sanoflow.

7. Funciona para contas pessoais?

   • Não. Apenas Business/Creator.

8. O que acontece se não conceder todas as permissões?

   • O acesso será limitado e recursos podem falhar.

9. Como resolver falhas de integração?

   • Revise permissões, vinculação ao Facebook e configurações no Business Manager.

10. Preciso de verificação de negócios?

• Sim, para liberar recursos avançados.