Instagram

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