Instagram Direct
A integração com o Instagram Direct permite que o MeuCardapio.ai receba e responda mensagens automáticamente no Direct do Instagram do seu estabelecimento. Combine o chatbot Mia com o Instagram para oferecer atendimento 24h, enviar o cardápio digital, receber pedidos e encaminhar conversas para atendentes humanos quando necessário.
O que essa integração faz
| Funcionalidade | Descrição |
|---|---|
| Atendimento automático | A Mia responde mensagens no Direct automáticamente |
| Menu rápido (Ice Breakers) | Botoes de atalho exibidos ao iniciar conversa: "Fazer pedido", "Ver cardapio", "Horario de atendimento" |
| Envio do cardapio | Envia o link do cardápio digital automáticamente |
| Encaminhar para humano | Transfere a conversa para um atendente humano quando a Mia não consegue resolver |
| Webhook em tempo real | Recebe notificações instantaneas de novas mensagens |
Pré-requisitos
Antes de configurar a integração, certifique-se de que todos os itens abaixo estejam prontos:
| Requisito | Detalhes |
|---|---|
| Conta Instagram Business ou Creator | Contas pessoais não suportam a API de mensagens. Converta para conta Business nas configurações do Instagram |
| Página do Facebook vinculada | A conta Instagram Business deve estar conectada a uma Página do Facebook |
| Mia configurada | O chatbot Mia deve estar configurado e ativo no MeuCardapio.ai |
| Plano compatível | Plano do MeuCardapio.ai que inclua integração com Instagram |
A API do Instagram Direct nao funciona com contas pessoais. Converta sua conta para Business ou Creator antes de prosseguir. Acesse: Instagram > Configurações > Conta > Mudar para conta profissional.
Conectar o Instagram
Passo 1: Acessar a configuração
- No painel administrativo, acesse Instagram Bot > Configurar Instagram Direct
- Clique em Conectar conta Instagram
Passo 2: Autorizar o acesso
- O sistema redireciona para a página de autorização do Instagram
- Faca login com a conta Instagram Business do estabelecimento
- Autorize as permissões solicitadas:
| Permissao | Finalidade |
|---|---|
| instagram_business_basic | Acesso ao perfil e informações básicas |
| instagram_business_manage_messages | Enviar e receber mensagens no Direct |
| instagram_business_manage_comments | Gerenciar comentarios (para futura integração) |
| instagram_business_content_publish | Publicar conteudo (para futura integração) |
| instagram_business_manage_insights | Acessar metricas e insights |
- Apos autorizar, o sistema redireciona de volta ao painel
Passo 3: Validação automática
Apos a autorização, o sistema executa automáticamente:
- Troca o código por token de acesso
- Converte para token de longa duração (valido por 60 dias)
- Obtem os dados do perfil (username, tipo de conta)
- Habilita webhooks para receber mensagens em tempo real
- Configura Ice Breakers (menu rápido no Direct)
O token de acesso tem validade de 60 dias. Quando faltarem menos de 7 dias para expirar, o sistema alerta para renovação. Renove pelo painel em Instagram Bot > Renovar Token.
Ice Breakers (Menu rápido)
Os Ice Breakers sao botoes de atalho exibidos quando o cliente inicia uma conversa no Direct. O sistema configura automáticamente tres opções:
| Botao | Acao (Payload) | O que acontece |
|---|---|---|
| Fazer pedido | FAZER_PEDIDO | A Mia inicia o fluxo de pedido e envia o link do cardápio |
| Ver cardapio | CARDAPIO | Envia o link direto do cardápio digital |
| Horario de atendimento | HORARIO_ATENDIMENTO | Informa os horarios de funcionamento |
Para reconfigurar os Ice Breakers manualmente:
- Acesse Instagram Bot > Configurar Instagram Direct
- Clique em Configurar Ice Breakers
Configurar respostas automáticas
A Mia responde automáticamente as mensagens recebidas no Instagram Direct. Configure o comportamento em Mia Atendente > Configurações:
Fluxo via Typebot
Se utilizar o Typebot como motor de fluxo:
- Acesse Mia Atendente > Configurações
- Ative a opção Usar fluxo Typebot
- Preencha o ID do fluxo Instagram (diferente do fluxo WhatsApp)
- Informe o Public ID do fluxo Instagram
- Salve as configurações
| Campo | Descrição |
|---|---|
| ID Fluxo Typebot Instagram | Identificador do fluxo Typebot específico para Instagram |
| Public ID Fluxo Instagram | ID público do fluxo, usado para iniciar conversas |
| Chave API Typebot | Chave de autenticação com o servico Typebot |
| Workspace ID | Identificador do workspace no Typebot |
O Instagram pode ter um fluxo Typebot diferente do WhatsApp. Configure cada um separadamente para adaptar a experiencia ao canal.
Modelo da Mia
O modelo escolhido para a Mia afeta o tamanho do histórico de conversa mantido:
| Modelo | Histórico |
|---|---|
| Básico | 2 mensagens |
| Intermediário | 6 mensagens |
| Avançado | 30 mensagens |
Encaminhar para atendente humano
Quando a Mia não consegue resolver a dúvida do cliente, a conversa pode ser transferida para um atendente humano. Configure o comportamento em Mia Atendente > Configurações:
| Configuração | Descrição |
|---|---|
| Comportamento fora do escopo | Define o que acontece quando a Mia não entende a mensagem |
| Tempo de pausa da Mia | Tempo (em segundos) que a Mia fica inativa após transferir para humano. Apos esse tempo, a Mia volta a responder automáticamente |
Webhooks
O sistema recebe notificações em tempo real quando novas mensagens chegam no Instagram Direct. O webhook e configurado automáticamente durante a conexao.
Para verificar o status dos webhooks:
- Acesse Instagram Bot > Configurar Instagram Direct
- Clique em Status Subscriptions
Se os webhooks estiverem inativos:
- Clique em Habilitar Subscriptions
- Aguarde a confirmação
Testar a conexao
Para verificar se a integração está funcionando:
- Acesse Instagram Bot > Configurar Instagram Direct
- Clique em Testar Conexao
- O sistema verifica se o token e valido e retorna o status
Renovar token
O token de acesso do Instagram expira a cada 60 dias. Para renovar:
- Acesse Instagram Bot > Configurar Instagram Direct
- Clique em Renovar Token
- O sistema obtem um novo token de longa duração automáticamente
Se o token expirar, será necessário reconectar a conta do zero. Renove sempre que o sistema alertar (faltando 7 dias ou menos).
Desconectar a conta
Para remover a integração com o Instagram:
- Acesse Instagram Bot > Configurar Instagram Direct
- Clique em Desconectar
- Confirme a ação
A conta será desativada no sistema. Os dados históricos de conversas serao mantidos.
Boas práticas
- Responda rápido -- O Instagram prioriza contas que respondem em menos de 1 hora. Com a Mia ativa, isso acontece automáticamente
- Personalize os Ice Breakers -- Os botoes de atalho ajudam o cliente a iniciar a conversa mais rápido
- Monitore o token -- Fique atento aos alertas de expiração para evitar interrupções no atendimento
- Use fluxos separados -- Crie um fluxo Typebot específico para Instagram, adaptando linguagem e opções ao perfil do público da rede
- Teste periodicamente -- Use a função "Testar Conexao" semanalmente para garantir que tudo está funcionando
- Configure a pausa da Mia -- Defina um tempo de pausa adequado para que atendentes humanos tenham tempo de responder antes da Mia retomar
Perguntas frequentes
Posso usar com conta pessoal do Instagram?
Não. A API de mensagens do Instagram exige uma conta Business ou Creator. Converta sua conta nas configurações do Instagram.
O chatbot responde Stories tambem?
Atualmente, a integração cobre apenas mensagens no Direct. Respostas a Stories e comentarios em publicações poderao ser suportados em versões futuras.
Preciso ter uma página no Facebook?
Sim. Contas Instagram Business precisam estar vinculadas a uma Página do Facebook. Isso e um requisito da API da Meta.
O que sao Ice Breakers?
Sao botoes de atalho que aparecem quando o usuario abre uma conversa nova no Direct. Facilitam o inicio da interação com opções pre-definidas como "Fazer pedido" ou "Ver cardapio".
O token expirou e a Mia parou de responder. O que fazer?
Acesse o painel e clique em Renovar Token. Se o token ja tiver expirado completamente, será necessário reconectar a conta clicando em Conectar conta Instagram novamente.
Posso usar Instagram Direct e WhatsApp ao mesmo tempo?
Sim. Ambos os canais funcionam de forma independente. A Mia pode atender nos dois canais simultaneamente, inclusive com fluxos Typebot diferentes para cada um.
Quantas mensagens o histórico armazena?
Depende do modelo da Mia escolhido: Básico (2 mensagens), Intermediário (6 mensagens) ou Avançado (30 mensagens). Escolha de acordo com a complexidade das conversas do seu estabelecimento.
O cliente sabe que está falando com um bot?
Depende da configuração. E uma boa pratica informar que o atendimento inicial e automatizado e que o cliente pode solicitar um atendente humano a qualquer momento.