Como integrar com a Vnda?
Como configurar a integração?
Dentro do Notificações Inteligentes
Para criar a integração, acesse a sua conta do Notificações Inteligentes e clique em Lojas:
Na página, clique em Criar loja:
Em seguida, na opção Descrição, é possível dar um apelido para a integração criada:
Na Plataforma, selecione a opção com o nome da integração, na categoria E-Commerce, como demonstrado na imagem abaixo:
Dentro da Vnda
Para fazer a integração, você terá que executar algumas tarefas quando chegar na tela onde existem os campos de URL da API e Token da API. Veja:
Então, entre em sua conta na Vnda e, no canto superior direito, selecione a opção Ir para Loja:
Em seguida, copie a URL da sua loja na Vnda, e depois cole na opção URL da API do Notificações Inteligentes:
Está URL deve ser retirada de seu painel inicial.
Ainda em sua conta na Vnda, procure por um ícone de Engrenagem, localizado no menu lateral:
Procure pela seção Integrações e depois clique em API:
Agora, clique no ícone de + e preencha os dados necessários. Então, clique em Continuar:
Após seguir os passos acima, fique atento ao e-mail que foi informado na configuração de sua chave, pois você receberá neste e-mail a sua Token API:
É importante que você guarde este e-mail ou a sua Token para uso futuro!
Depois de guardar a sua token, copie a mesma e cole no Notificações Inteligentes, na opção Token da API; em seguida e clique em Configurar:
Atenção! A integração ainda não está terminada!
Volte em sua conta na Vnda e procure por um ícone de Engrenagem, localizado no menu lateral:
Procure pela seção Integrações e logo após clique em Webhooks:
Agora, clique em no ícone de +:
Este próximo passo será um pouco mais demorado e exigirá mais atenção. Se a configuração não for feita da maneira correta, você poderá perder notificações de alguns eventos!
Nos escopos você vai selecionar: CARRINHO, CLIENTE, PEDIDO, EVENTOS E PRODUTOS
Após o clique, selecione o evento. No campo URL, coloque a URL da integração da Vnda que você criou no Notificações Inteligentes. Este passo irá se repetir algumas vezes.
Segue abaixo a lista de eventos que vão ser configurados um a um:
Caso não saiba onde pegar a URL no Notificações Inteligentes, acesse este artigo e siga o passo a passo.
• order-canceled;
• order-confirmed;
• order-received;
• package-sent;
• package-shipped;
• package-delivered;
• cart-abandoned.
Para finalizar, clique em Salvar.
Pronto! Sua integração foi feita com sucesso! Agora vamos começar a receber os eventos e, consequentemente, enviar as notificações.
Rastreamento
Essa plataforma não possui variáveis de rastreamento!
Infelizmente a plataforma não nos envia os dados de rastreamento sobre as transações, por isso sugerimos que você solicite ao seu gerente de contas, ou ao suporte da plataforma que elas sejam disponibilizadas.
Como sei que deu certo?
Quer conferir se a integração do Notificações Inteligentes foi feita de maneira certa? Então, veja como você pode fazer a confirmação, seguindo estas etapas:
Verifique o checklist dentro da sua loja
Temos um checklist que te ajuda a entender se todas as configurações necessárias para o envio das notificações foram feitas.
Você consegue ter um exemplo do checklist logo abaixo:
Se todas as opções estiverem na cor verde, quer dizer que você fez todos os passos. Então, provavelmente, as notificações já devem estar sendo enviadas.
Para que você receba os eventos de rastreio é necessario solicitar a liberação dessa função ao suporte deles, orientação da própria VNDA!
Acompanhe a tela de relatórios
Na tela de relatórios, seja da integração ou da instância, você consegue ter uma ideia geral das notificações que estão sendo enviadas.
Caso não saiba onde fica esta tela, acesse este artigo para saber como verificar os relatórios.
Verifiquei todos os passos acima e mesmo assim acredito que não esteja funcionando
Nesse caso, temos um checklist mais detalhado que você consegue ver ele aqui.
Quando as notificações serão disparadas?
Como essa é uma integração instantânea, assim que a plataforma nos enviar as informações, iremos processar e agendar a mensagem na fila de envios. Caso você não saiba o que é uma fila de envios, clique aqui.
Carrinho Abandonado
A plataforma demora em torno de 10 a 15 minutos para reconhecer o abandono de carrinho e nos enviar o evento.
Quais são as notificações disponíveis?
Todas as notificações listadas na tabela abaixo estão disponíveis e funcionando. Antes de você conhecê-las, entenda como cada uma delas funciona.
Veja, então, o que significa cada coluna das notificações disponíveis:
• Prioridade no caminho feliz: se esta função estiver disponível, ela vai indicar a ordem de envio das mensagens seguindo a lógica do chamado “caminho feliz”. Você pode ler mais sobre ele aqui;
• Nome da notificação: é o nome que damos para a notificação dentro do nosso painel;
• Como reconhecemos o evento: em algumas integrações, deixamos documentada a maneira como elas são reconhecidas pelo nosso sistema. Isso acontece porque algumas delas podem ser personalizadas. Mas, se o reconhecimento não estiver disponível, pode ficar tranquilo pois isso não afeta qualquer usabilidade do sistema.
Clique na imagem para aumentar
Dentro do Notificações Inteligentes
Para criar a integração, acesse a sua conta do Notificações Inteligentes e clique em Lojas:
Na página, clique em Criar loja:
Em seguida, na opção Descrição, é possível dar um apelido para a integração criada:
Na Plataforma, selecione a opção com o nome da integração, na categoria E-Commerce, como demonstrado na imagem abaixo:
Dentro da Vnda
Para fazer a integração, você terá que executar algumas tarefas quando chegar na tela onde existem os campos de URL da API e Token da API. Veja:
Então, entre em sua conta na Vnda e, no canto superior direito, selecione a opção Ir para Loja:
Em seguida, copie a URL da sua loja na Vnda, e depois cole na opção URL da API do Notificações Inteligentes:
Está URL deve ser retirada de seu painel inicial.
Ainda em sua conta na Vnda, procure por um ícone de Engrenagem, localizado no menu lateral:
Procure pela seção Integrações e depois clique em API:
Agora, clique no ícone de + e preencha os dados necessários. Então, clique em Continuar:
Após seguir os passos acima, fique atento ao e-mail que foi informado na configuração de sua chave, pois você receberá neste e-mail a sua Token API:
É importante que você guarde este e-mail ou a sua Token para uso futuro!
Depois de guardar a sua token, copie a mesma e cole no Notificações Inteligentes, na opção Token da API; em seguida e clique em Configurar:
Atenção! A integração ainda não está terminada!
Volte em sua conta na Vnda e procure por um ícone de Engrenagem, localizado no menu lateral:
Procure pela seção Integrações e logo após clique em Webhooks:
Agora, clique em no ícone de +:
Este próximo passo será um pouco mais demorado e exigirá mais atenção. Se a configuração não for feita da maneira correta, você poderá perder notificações de alguns eventos!
Nos escopos você vai selecionar: CARRINHO, CLIENTE, PEDIDO, EVENTOS E PRODUTOS
Após o clique, selecione o evento. No campo URL, coloque a URL da integração da Vnda que você criou no Notificações Inteligentes. Este passo irá se repetir algumas vezes.
Segue abaixo a lista de eventos que vão ser configurados um a um:
Caso não saiba onde pegar a URL no Notificações Inteligentes, acesse este artigo e siga o passo a passo.
• order-canceled;
• order-confirmed;
• order-received;
• package-sent;
• package-shipped;
• package-delivered;
• cart-abandoned.
Para finalizar, clique em Salvar.
Pronto! Sua integração foi feita com sucesso! Agora vamos começar a receber os eventos e, consequentemente, enviar as notificações.
Rastreamento
Essa plataforma não possui variáveis de rastreamento!
Infelizmente a plataforma não nos envia os dados de rastreamento sobre as transações, por isso sugerimos que você solicite ao seu gerente de contas, ou ao suporte da plataforma que elas sejam disponibilizadas.
Como sei que deu certo?
Quer conferir se a integração do Notificações Inteligentes foi feita de maneira certa? Então, veja como você pode fazer a confirmação, seguindo estas etapas:
Verifique o checklist dentro da sua loja
Temos um checklist que te ajuda a entender se todas as configurações necessárias para o envio das notificações foram feitas.
Você consegue ter um exemplo do checklist logo abaixo:
Se todas as opções estiverem na cor verde, quer dizer que você fez todos os passos. Então, provavelmente, as notificações já devem estar sendo enviadas.
Para que você receba os eventos de rastreio é necessario solicitar a liberação dessa função ao suporte deles, orientação da própria VNDA!
Acompanhe a tela de relatórios
Na tela de relatórios, seja da integração ou da instância, você consegue ter uma ideia geral das notificações que estão sendo enviadas.
Caso não saiba onde fica esta tela, acesse este artigo para saber como verificar os relatórios.
Verifiquei todos os passos acima e mesmo assim acredito que não esteja funcionando
Nesse caso, temos um checklist mais detalhado que você consegue ver ele aqui.
Quando as notificações serão disparadas?
Como essa é uma integração instantânea, assim que a plataforma nos enviar as informações, iremos processar e agendar a mensagem na fila de envios. Caso você não saiba o que é uma fila de envios, clique aqui.
Carrinho Abandonado
A plataforma demora em torno de 10 a 15 minutos para reconhecer o abandono de carrinho e nos enviar o evento.
Quais são as notificações disponíveis?
Todas as notificações listadas na tabela abaixo estão disponíveis e funcionando. Antes de você conhecê-las, entenda como cada uma delas funciona.
Veja, então, o que significa cada coluna das notificações disponíveis:
• Prioridade no caminho feliz: se esta função estiver disponível, ela vai indicar a ordem de envio das mensagens seguindo a lógica do chamado “caminho feliz”. Você pode ler mais sobre ele aqui;
• Nome da notificação: é o nome que damos para a notificação dentro do nosso painel;
• Como reconhecemos o evento: em algumas integrações, deixamos documentada a maneira como elas são reconhecidas pelo nosso sistema. Isso acontece porque algumas delas podem ser personalizadas. Mas, se o reconhecimento não estiver disponível, pode ficar tranquilo pois isso não afeta qualquer usabilidade do sistema.
Clique na imagem para aumentar
Atualizado em: 19/09/2024
Obrigado!