Nesta página você irá encontrar todas as informações necessárias para conectar seu assistente do Zenvia NLU ao Instagram
Como funciona?
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.
Pré-requisitos
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.
Restrições
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.
Criar integração no Zenvia NLU
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 @.
Configurações adicionais
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
Configurar Integração no App Zenvia
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.
Se precisar de mais ajuda, acesse a documentação de Webhooks da Zenvia.
Entrada e saída de mensagens
É 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 updated
Was this helpful?