.svg?alt=media&token=d4e6f36f-8994-47d0-b855-83e47927012c)
Nesta página você irá encontrar todas as informações necessárias para conectar seu assistente do Zenvia NLU ao Instagram
A integração do Zenvia NLU com o Instagram acontece por intermédio da Zenvia. Sendo assim, todo o funcionamento do assistente consiste na integração do App Zenvia com o Instagram do cliente, e a posterior configuração de um webhook entre Zenvia NLU e Zenvia.
- Integração com a Zenvia: certifique-se que sua conta do Instagram está corretamente integrada ao App Zenvia. Caso ainda não tenha feito essa configuração siga este passo-a-passo;
- Sender ID: é o identificador do remetente da mensagem. Ele identifica de forma única a conta que está enviando as mensagens, e é fornecido pela Zenvia;
- API Token: chave necessária para a autenticação com a API Zenvia, também fornecido pela Zenvia.
Por enquanto, o Instagram não permite que assistentes virtuais iniciem conversas. Dessa forma, a atuação dos assistentes está restrita a responder mensagens iniciadas pelos usuários.
Para isso, acesse Connect > Canais > Instagram. Na tela "Integrações com Zenvia Instagram", clique no botão ➕, no canto inferior direito, crie uma nova integração e preencha os seguintes campos:
- Nome*: nome da sua integração (você pode alterar essa informação depois);
- Assistente*: selecione o assistente que deseja integrar ao Instagram;
- Squads: selecione o nome da squad, se estiver disponível na lista. Caso contrário, mantenha como “geral”;
- Sender ID*: informe o Sender ID. Essa informação está no App Zenvia, em Meu Menu > Integrações > Instagram. Ao encontrar na lista a conta que deseja vincular seu assistente, clique em Copiar Sender ID e use-a nesse campo;
- API Token*: token para autorização de envio de mensagens. Você pode gerar seu token no console da API dentro da plataforma Zenvia. Se precisar de ajuda, acesse a documentação da Zenvia;
- Mensagens para mídias não suportadas (opcional): cadastre mensagens que serão exibidas caso o usuário envie um tipo de informação não suportada.
- Usuários de homologação (opcional): nomes de usuários para teste do fluxo de atendimento. Utilize o seu nome de usuário do Instagram, sem o @.
Após criar a integração, clique no botão editar integração.
Então, você poderá consultar sua URL de Webhook, que será utilizada na configuração da integração do Zenvia NLU com o App Zenvia.
Também é possível fazer algumas configurações extras, como:
- Inatividade (opcional): ao marcar essa opção o atendimento será reiniciado ao identificar inatividade do usuário após o tempo definido.
- Mínimo: 10 min
- Máximo: 1440 min (24 horas)
- Padrão: 60 min
Acesse o portal Zenvia e vá para Produtos > Tokens e Webhooks para acessar o console da API.
Na seção Webhooks, clique no botão "Criar Novo" para criar um novo webhook e preencha os seguintes campos:
- Status: o status da subscrição. Deixe essa opção ativa;
- Versão: a versão da subscrição. Selecione a opção v2;
- Tipo do evento: o tipo do evento da subscrição. Selecione a opção Mensagem;
- Canal: o canal da subscrição. Selecione a opção Instagram;
- URL: URL usada para receber as mensagens de seus clientes. Consulte a URL na plataforma Zenvia NLU, em Entrada de Mensagens da seção Webhooks;
- Cabeçalhos: informações de autenticação na chamada de webhook. Adicione dois cabeçalhos, um para Username e outro para AuthenticationToken. Consulte os cabeçalhos na plataforma Zenvia NLU, no Header da seção Webhooks.
É possível receber mensagens como:
- Texto
- Áudio
- Vídeo
É possível enviar mensagens como:
- Texto
Os componentes de quick reply, select, e option list serão convertidos para texto
- Imagem
Arquivos sem type definido no payload serão enviados ao usuário e poderão ser exibidos caso sejam do tipo imagem. Caso o type esteja definido no payload e não for do tipo imagem, uma mensagem de texto contendo a URL de download será enviada ao usuário
Last modified 5mo ago