Soluções NBS - Plugins Mercado - Zenvia

De Wiki NBS
Ir para navegação Ir para pesquisar

Seta-topo.png

Página principal > Sistema NBS - Plugins > Plugins Mercado - Zenvia


Conceito

Após a contratação da Integradora, o usuário fará o cadastro no portal da Zenvia. Este cadastro é importante, pois a NBS irá utilizar algumas informações para a comunicação junto à Integradora.

Os passos exemplificados abaixo, será apenas do cadastro no portal, a parte que antecede (contratação) será de responsabilidade do usuário.


Zenvia

Plugins Mercado - Zenvia.png Acesse o portal da Zenvia, no seguinte endereço: https://www.zenvia.com/
Plugins Mercado - Zenvia - Login.png Acesse utilizando os dados da conta (fornecidos pela Zenvia);

Sobre a Organização

Antes de iniciar a configuração/cadastro, é importante esclarecermos alguns pontos:

  1. Vínculo da Organização:
    • Na tela do Menu Principal (após o login) acesse a organização ao clicar sob o nome do usuário (canto superior direito), será exibido todas as organizações para qual o usuário pertence (possui contrato);
  2. Telefone Vinculado:
    • É importante que o usuário se atente que só deve possuir um número (telefone) por organização (normalmente a Zenvia vincula várias organizações para um mesmo número), pois no processo de integração com a NBS, será utilizado este número para identificar da organização (integradora);

Cadastro Token

O cadastro do Token é um requisito importante para a utilização do LeadZap (CRM Parts).

Plugins Mercado - Zenvia - Desenvolvedor.png Acesse:
  1. Zenvia > Desenvolvedores > Tokens e Webhooks
  2. Cadastre o Token.
Plugins Mercado - Zenvia - Desenvolvedor - Criar Novo Token.png Clique no botão: Criar Novo
Plugins Mercado - Zenvia - Desenvolvedor - Novo Token.png Preencha os campos:
  • Nome do Token;
    • No campo digitavel, informe um nome para o Token
      • Este nome será utilizado nas aplicações dos módulos do NBS;
  • Tipo de Autenticação
    • Selecione o Tipo de Aplicação a ser utilizado.
  • Clique no botão Salvar
Plugins Mercado - Zenvia - Desenvolvedor - Novo Token - Token.png O Token foi criado.

Copie o Token - esta informação será utilizada nos módulos NBS.


Atenção: Clique no botão: Baixar CSV, para que o usuário tenha o número do Token criado (para a utilização no cadastro), pois uma vez salvo este número não será mais exibido completo e não mais será possível efetuar sua cópia.
Clique em fechar, para retornar à página anterior.

Atenção: Para este exemplo criamos um Token fictício, portanto não utilize esta informação em seu cadastro.

Plugins Mercado - Zenvia - Desenvolvedor - Novo Token - Token Criado.png A página irá exibir a informação do Token criado.

Cadastro webhook

Plugins Mercado - Zenvia - Desenvolvedor.png Acesse:
  1. Zenvia > Desenvolvedores > Tokens e Webhooks
  2. Cadastre o webhook (IP do Servidor Linux externo/DNS - com porta liberada para o IP Zenvia).
Plugins Mercado - Zenvia - Desenvolvedor - Novo Token - Webhook.png Clique no botão: Criar Novo
Plugins Mercado - Zenvia - Desenvolvedor - Novo Token - Webhook - Novo Webhook.png Preencha os campos:
  • Status
    • Selecione o Status ATIVO;
  • Versão
    • Selecione a Versão;
  • Tipo do Evento
    • Selecione o Tipo de Evento;
  • Canal
    • Selecione o Canal de utilização;
  • URL
    • Monte a URL, seguindo o modelo para WhatsApp (mensagem):
      • http:// + IP Linux + /nbsapi-gateway/nbs/whatsapp/plugin-zenvia/mensagens/in
    • WhatsApp (Status da Mensagem):
      • http:// + IP Linunx + /nbsapi-gateway/nbs/whatsapp/plugin-zenvia/mensagens/status
  • Clique no botão Salvar
Plugins Mercado - Zenvia - Desenvolvedor - Novo Token - Webhook - URL Criada.png A página irá exibir a informação da URL criada.

Integrações

Plugins Mercado - Zenvia - Produtos - Integrações.png Nesta área o usuário poderá efetuar a cópia das informações criadas para as Integrações dos aplicativos utilizados.
Plugins Mercado - Zenvia - Produtos - Integrações - WhatsApp.png Para este exemplo utilizaremos a integração com o WhatsApp.

Clique no botão: Gerenciar.

Plugins Mercado - Zenvia - Produtos - Integrações - WhatsApp - Copia ID.png Será exibido as contas conectadas, o usuário poderá efetuar a cópia do ID ao clicar no botão: Copiar Sender ID (conforme imagem identificada ao lado).

Página principal > Sistema NBS - Plugins > Plugins Mercado - Zenvia