LogoLogo
Zenvia Docs
  • Zenvia NLU
  • Boas Práticas
    • Eventos
      • Dicas para criar eventos
      • Eventos Personalizados
        • menu_principal
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • Autosservico
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • sucess_no_friccion
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • horario_atendimento
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • transbordo
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • pesquisa_satisfacao
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • conseguiu_ajudar
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • nivel_confianca
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • chamada_api
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • falha_api
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • primeiro_acesso
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • encerramento
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • estouro_tentativas_else
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • intents
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • rechamada
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
    • Gestão de NLU
      • Dicas de gestão de NLU
    • Personalizar widget
  • Monitor
    • Dashboard
      • Métricas e indicadores
      • Gráficos
    • Atendimentos
    • Eventos
    • Volumetria
    • Issues
    • Monitoramento de APIs
    • Métricas de avaliação
  • Build
    • Assistentes
      • Edição do Assistente
      • Builder
        • Configurações do nó
        • Componentes
          • Output
            • Texto
            • Texto randômico
            • Texto sequencial
            • Base de conhecimento
            • LivePerson - Conteúdo Estruturado
            • Arquivo
          • Input
            • Pergunta aberta
            • Autocomplete
            • Data
            • Feedback NPS
            • Feedback Custom
            • Lista inline
            • Lista modal
            • Quick Replies
            • Upload de arquivo
            • Upload de arquivo LP
            • Carrossel de Opções
            • Desambiguação
          • Fluxo de Inatividade
          • Variáveis
          • Ações
            • HTTP Request
            • Satisfaction
            • Validar celular
            • Validar CEP
            • Validar CPF
            • Validar CPF/CNPJ
            • Validar CNPJ
            • Validar nome completo
            • Validar e-mail
            • Procurar atendimento
            • Transferência entre skills Liveperson
            • Setar contexto LivePerson
            • Encerrar Atendimento LivePerson
            • Encerrar chat
            • Socket Event
            • Facebook Profile
            • Facebook Transbordo
            • Workplace Profile
            • Iniciar LiveChat
            • Functions
            • Setar NLU
            • Transferência entre assistentes
            • Contact Return
            • Intent Feedback
          • Eventos
    • Functions
    • Atributos
  • CONNECT
    • APIs
      • Agent connector API
      • Outbound
        • Outbound WhatsApp
        • Outbound Zenvia
        • Outbound Wavy
        • Outbound LivePerson
        • Outbound Infobip
        • Outbound RCS
      • Eventos
      • Atendimentos
      • LGPD
    • Canais
      • Capabilities
      • Instagram
      • Google Business Messages
      • Bot API
      • Facebook
        • Integração Messenger via Zenvia NLU
        • Integração Messenger via Liveperson
      • Google RCS
      • Microsoft Teams
      • Whatsapp
        • Zenvia
        • Blip
        • Wavy
        • Infobip
        • Liveperson
      • Widget
      • Workplace
    • Telegram
    • Contingência
    • LiveChat
      • Transbordo ALTU Connector API
        • Transbordo Tech4Humans
      • Transbordo LivePerson
      • Transbordo Zendesk Ticket
      • Transbordo Zendesk Chat
      • Transbordo Salesforce
  • TRAIN
    • Primeiros passos
    • Visão Geral
    • Configuração do NLU
    • Avaliação de Mensagens
    • Análise e ajustes
  • Mais
    • Release
      • Controle de Versão
      • 27/10/2021
      • 06/10/2021
      • 22/09/2021
      • 09/09/2021
      • 11/08/2021
      • 28/07/2021
      • 14/07/2021
      • 30/06/2021
      • 16/06/2021
      • 01/06/2021
      • 18/05/2021
      • 04/05/2021
      • 20/04/2021
      • 06/04/2021
      • 23/03/2021
      • 09/03/2021
      • 23/02/2021
      • 09/02/2021
      • 26/01/2021
      • 12/01/2021
      • 22/12/2020
      • 08/12/2020
      • 24/11/2020
      • 10/11/2020
      • 27/10/2020
      • 13/10/2020
      • 29/09/2020
      • 15/09/2020
      • 01/09/2020
      • 18/08/2020
      • 03/08/2020
      • 21/07/2020
      • 08/07/2020
      • 30/06/2020
      • 04/06/2020
      • 22/05/2020
      • 14/05/2020
      • 29/04/2020
      • 01/04/2020
      • 24/03/2020
      • 16/03/2020
    • Glossário
Powered by GitBook
On this page
  • Como funciona?
  • Pré-requisitos
  • Restrições
  • Criar integração no Zenvia NLU
  • Configurações adicionais
  • Configurar Integração no App Zenvia
  • Entrada e saída de mensagens

Was this helpful?

  1. CONNECT
  2. Canais

Instagram

Nesta página você irá encontrar todas as informações necessárias para conectar seu assistente do Zenvia NLU ao Instagram

PreviousCapabilitiesNextGoogle Business Messages

Last updated 2 years ago

Was this helpful?

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 . Caso ainda não tenha feito essa configuração ;

  • 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, ;

  • 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.

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;

  • 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.

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

Então, você poderá consultar sua URL de Webhook, que será utilizada na

URL: URL usada para receber as mensagens de seus clientes. , em Entrada de Mensagens da seção Webhooks;

Se precisar de mais ajuda, .

App Zenvia
siga este passo-a-passo
acesse a documentação da Zenvia
acesse a documentação de Webhooks da Zenvia
configuração da integração do Zenvia NLU com o App Zenvia.
Consulte a URL na plataforma Zenvia NLU