Notificações & WebHook
A API do Zenvia Conversion permite notificar sistemas externos sobre eventos específicos na plataforma, utilizando Webhooks.
Um Webhook é uma solicitação HTTP POST enviada para um URL previamente registrado, contendo informações sobre o evento ocorrido.
Eventos disponíveis (Topics)Os eventos que pod
06. Cadastrar Webhook
No menu Automações, há a opção Webhook. Nesta funcionalidade, você pode receber comunicação em tempo real das interações de suas comunicações para acompanhar a efetividade de suas automações.
Nesta opção é possível:
Criar um novo Webhook;Editar ou testar um Webhook criado.⚠️ Atenção: Apenas usuários
01. Integrações - Webhook
A integração via webhook permite a comunicação com quase todas as ferramentas. O webhook permite enviar dados do atendimento e de recados do Zenvia Chat para qualquer outro sistema que esteja apto a recebê-los. É possível usar ferramentas como Zapier e Pluga para integrar de forma bem fácil com cent
08. Serviço: Webhook de eventos
O serviço Webhook de Eventos é responsável por enviar a um determinado endpoint todos os eventos que ocorreram nas comunicações enviadas pela plataforma.
SegurançaO endpoint deve ser uma URL pública que responda às requisições HTTP/HTTPS.
Também é importante que a URL não esteja num contexto de VPN
[Enterprise] Automação: Gatilhos, Webhook e Macros
As configurações de Automação permitem automatizar tarefas repetitivas e personalizar fluxos de trabalho por meio de regras que disparam ações automáticas, como atribuir tickets, atualizar campos ou enviar notificações. Isso aumenta a produtividade e eficiência no atendimento de suporte.
09. Serviço: Webhook de geração de documentos
O serviço Webhook de geração de documentos (DocGen) é responsável por enviar a um determinado endpoint todos os eventos que ocorreram na geração de um documento.
Segurança
O endpoint deve ser uma URL pública que responda às requisições HTTP/HTTPS.
Também é importante que a URL não esteja num contex
08. Boas práticas nos Webhooks
Implementar um webhook eficiente é mais fácil do que parece. Com algumas boas práticas, você cria um código que gerencia o webhook de forma rápida e confiável. Isso melhora o processamento do payload e garante entregas mais ágeis, sem enfileiramento ou perda de performance. Como resultado, uma integ
11. Como fazer Webhooks no SenseData
Agora é possível utilizar o Webhooks para atualizar automaticamente outros sistemas que você utiliza com informações contidas na plataforma SenseData.
Webhook é uma forma de transitar informações entre dois sistema de forma simplificada. Com o tráfego de dados em tempo real você ganha muita velocid
[Enterprise] Configuração e uso de Webhooks no Atendimento de Suporte
Os webhooks permitem enviar dados de tickets para outro sistema automaticamente quando condições específicas são atendidas. Essa abordagem é frequentemente mais simples do que uma configuração de API bidirecional, já que o sistema receptor não precisa iniciar uma solicitação de API para obter os dados do Atendimento de Suporte.
01. O que são LiveChats
LiveChats são softwares de chat ao vivo com seus clientes, ou seja, são plataformas que permitem que um atendente humano converse com seus clientes por meio de um canal de comunicação.
OpçõesVocê pode integrar o seu assistente da Zenvia NLU e configurar um transbordo para atendimento humano utilizan
06. Recebendo alertas de atividades concluídas via Slack
Você sabia que agora consegue criar alertas para avisar quando uma atividade é concluída no SenseData? Isso agora é possível através da nossa nova integração com o Slack!
Como isso pode ajudar minha empresa? Essa integração é uma poderosa ferramenta de comunicação interna em massa de maneira automá
02. Como acessar o Zenvia APIs
Antes de usar qualquer API da Zenvia, é necessário seguir alguns caminhos.
Neste artigo, você verá as etapas necessárias, como Criar uma conta e Criar um Token. Além disso, verá também como Registrar um Webhook, caso queira realizar o registro de um.
Criar Token
Registrar Webhook
Criar uma conta
06. Configurar Sandbox para teste de Telegram
Para configurar o Sandbox para teste no Telegram, em primeiro lugar é necessário seguir as etapas descritas neste artigo.
Em seguida, inclua a opção correspondente na etapa Selecione o canal e então clique em Próximo.
Definindo e validando o(s) contato(s)
A seguir, na etapa Contatos, você vai prec
03. Configurar Sandbox para teste de Instagram
Para configurar o Sandbox para teste no Instagram, em primeiro lugar é necessário seguir as etapas descritas neste artigo.
Em seguida, inclua a opção correspondente na etapa Selecione o canal e então clique em Próximo.
Definindo e validando o(s) contato(s)
A seguir, na etapa Contatos, você vai pre
02. Configurar Sandbox para teste de Facebook
Para configurar o Sandbox para teste no Facebook, em primeiro lugar é necessário seguir as etapas descritas neste artigo.
Em seguida, inclua a opção correspondente na etapa Selecione o canal e então clique em Próximo.
Definindo e validando o(s) contato(s)
A seguir, na etapa Contatos, você vai prec
07. Configurar Sandbox para teste de Whatsapp
Para configurar o Sandbox para teste no Whatsapp, em primeiro lugar é necessário seguir as etapas descritas no artigo Primeiros passos usando a Sandbox.
Após seguir as instruções dos primeiros passos, escolha o canal desejado e inclua a opção correspondente na etapa Selecione o canal e então clique
05. Configurar Sandbox para teste de SMS
Para configurar o Sandbox para teste de SMS, em primeiro lugar é necessário seguir as etapas descritas neste artigo.
Em seguida, inclua a opção correspondente na etapa Selecione o canal e então clique em Próximo.
Definindo e validando o(s) contato(s)
A seguir, na etapa Contatos, você vai precisar
04. Configurar Sandbox para teste de RCS
Para configurar o Sandbox para teste no RCS, em primeiro lugar é necessário seguir as etapas descritas neste artigo.
Em seguida, inclua a opção correspondente na etapa Selecione o canal e então clique em Próximo.
Definindo e validando o(s) contato(s)
A seguir, na etapa Contatos, você vai precisar
05. Google RCS
O RCS é um canal de comunicação feito pelo Google e possui recursos como: envio de localização, compartilhamento de informações, calendário, entre outros.
Compatibilidade
Utilize esses componentes para criar o assistente:
Informações aceitas
Texto
Arquivo: apenas imagens nos formatos jpeg, jpg, gif
Testes em Sandbox no Zenvia Customer Cloud
Importante: Antes de seguir com as instruções, confirme se a funcionalidade está disponível para o seu perfil de acesso.O módulo Testes em Sandbox foi projetado para oferecer e simplificar o processo de teste das nossas APIs.
Ele oferece um ambiente seguro onde desenvolvedores realizam testes rápi
02. Conceitos básicos
Aprenda sobre alguns conceitos básicos quando se trabalha com API.
Nesta seção, vamos nos concentrar na compreensão e definição dos principais conceitos para quem busca integrações robustas com nossas APIs de um jeito descomplicado.
💡 Dica: caso seja um desenvolvedor e procure por uma documentação
Como acessar as configurações de API via painel
Para acessar as configurações de API acesse o painel de voz pelo endereço https://voice-app.zenvia.com com as permissões de administrador, siga até o final da aba inferior.
Selecione a opção Ir para configuração de API.
Aqui nesta opção, você consegue realizar as configurações gerais de webhook
Leads API no Zenvia Conversion
Esta API foi desenvolvida com o propósito de proporcionar uma maneira assíncrona de enviar leads para o Zenvia Conversion, permitindo receber um webhook contendo os resultados. Saiba neste artigo os requisitos e como utilizar esta API na sua conta.
⚠️ Atenção: A integração de uma API demanda conheci
Configurações gerais
Tutoriais em vídeo do Zenvia Customer Cloud para configurar canais, encurtar links, configurar Webhooks e realizar testes no Sandbox.
03. Blip
A Take Blip é uma solução que possibilita a integração com o WhatsApp, caso a sua empresa possua uma conta na Blip e ofereça atendimento por meio do canal WhatsApp, poderá integrar este canal aos assistentes do Zenvia NLU e usufruir de todos os recursos sem a necessidade de trocar o número de atendi
06. Tipos de Fluxos (Ativo e Receptivo)
Com o Zenvia Bots é possível estruturar diferentes tipos de fluxos de acordo com cada necessidade de negócio.
Há duas formas de realizar a ativação de jornadas no Flow, definindo a forma como a comunicação será iniciada:
Fluxo ativo
É caracterizado quando há uma regra que inicia o fluxo através
02. Integração Whatsapp via Zenvia
Neste artigo, você encontrará todas as informações necessárias para conectar seu assistente Zenvia NLU ao WhatsApp.
Como funciona
A integração da Zenvia NLU com o WhatsApp acontece por intermédio da Zenvia.
Sendo assim, todo o funcionamento do assistente consiste na integração do App Zenvia com o Wh
01. Visão Geral do WhatsApp
Antes de criar uma integração com o canal WhatsApp do Facebook, certifique-se que a sua empresa foi inclusa na prévia pública limitada da WhatsApp Business API.
Caso sua empresa não tenha acesso à API do WhatsApp Business, poderá solicitar a inclusão acessando https://www.facebook.com/business/m/wha
07. Microsoft Teams
O Teams é uma plataforma desenvolvida pela Microsoft com objetivo de unificar a experiência de comunicação e colaboração, utilizando ferramentas como sala de bate-papo, videoconferências, armazenamento de arquivos e integração de vários aplicativos no ambiente de trabalho.
Saiba como usar e implanta
13. Configurando uma URA ativa com avaliação de atendimento
URA, ou Unidade de Resposta Audível, é um tipo de atendente eletrônica capaz de identificar dígitos e voz, e reagir a partir dessas informações. Configurando uma URA através da nossa API de comunicação, você poderá enviar uma pesquisa de satisfação para um número (celular ou fixo), que ouvirá uma
Perguntas frequentes: API
Aqui você encontrará todas as informações que precisa para começar a trabalhar com a nossa API.
Com este artigo você poderá resolver a grande maioria de suas dúvidas sobre o API Zenvia Conversion.
Neste link você encontrará uma coleção de Postman com as request disponíveis na API de Zenvia Conversio
04. Transbordo Zendesk Ticket
Nome: nome do LiveChat;
Provedor: Zendesk Ticket;
Usuário Webhook: nome à escolha de quem estiver configurando;
Senha Webhook: senha à escolha de quem estiver configurando.
Sendo um usuário credenciado, acesse a instância na Zendesk do cliente desejado.
A seguir Configurações > Canais > API.
Nessa
02. Editar assistente
Para editar um assistente, basta clicar no ícone sinalizado com um lápis.
Em seguida, a nova tela funcionará como uma visão geral do assistente e contém as principais informações relacionadas às configurações, como:
Nome do assistente;Data e horário do último atendimento;Atualização da programação;
Ações dos agentes especialistas de suporte
Sempre que um ticket sofre uma alteração, o sistema verifica se algum agente especialista de suporte tem condições configuradas para aquele cenário. Se tiver, as ações vinculadas a esse agente são executadas automaticamente. Esta é a etapa final da configuração do agente e onde você define as ações de sucesso a serem tomadas, como, por exemplo, o envio automático de mensagens.
04. Wavy
A Wavy é uma plataforma de comunicação que permite a integração com canais como o WhatsApp, Apple Business Chat e envio de SMS. Caso a sua empresa possua uma conta na Wavy e ofereça atendimento por meio do canal WhatsApp, poderá integrar este canal ao seu assistente.
Configuração
Para começar, solic
06. Instagram
Neste artigo, você 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
02. Transbordo Tech4Humans
Nesta página você irá encontrar um exemplo de configuração utilizando Zenvia NLU Connector API para transbordo com a Tech4Humans.
Integração Zenvia NLU Connector
Crie uma nova conexão no LiveChat na Zenvia NLU acessando a aba Connect > Live Chats.
Para solicitar o cadastro de um Webhook, é necessár
03. Como testar um fluxo
Ao criar um fluxo na Zenvia Bots, por padrão, é escolhido um canal conversacional para que a jornada seja integrada e executada com sucesso.
Cada canal possui algumas particularidades relacionadas a testes, às vezes atreladas até mesmo pelas regras de negócio (exemplo de Facebook e Whatsapp). Por
21. Ações/Opções de uma URA Dinâmica
A URA dinâmica sempre esta associada a uma URA no painel da plataforma de voz Zenvia a qual está com a opção dinâmica ativada e com o campo de texto preenchido com a url do endpoint.
É neste endpoint que iremos buscar o arquivo json dinamicamente.
Você pode associar a URA em um DID (número rece
05. Infobip
A Infobip é uma plataforma de comunicação omnichannel, que possibilita a integração com canais de mensageria como o Google RCS, Facebook Messenger e WhatsApp. Caso a sua empresa possua uma conta na Infobip e ofereça atendimento por meio do WhatsApp, poderá integrar este canal ao seu assistente.
Conf
01. Primeiros passos usando a Sandbox
A Sandbox é a maneira mais fácil e rápida de começar a usar as APIs da Zenvia.
Com essa ferramenta sem custo ou necessidade de contratação, você consegue testar nossas APIs sem precisar realizar qualquer integração nos principais canais:
Facebook
Instagram
RCS
SMS
Telegram
Whatsapp
Primeiros pas
02. Como fazer a integração do fluxo
Ao finalizar o processo do seu fluxo, clique em Integrar fluxo, conforme abaixo.
Nesta tela, você deverá informar o Token e o Webhook. Essas informações são importantes, pois o seu fluxo precisa saber como o seu canal irá se comunicar.
Por fim, clique no botão Integrar fluxo.
Ao clicar n
04. Construindo um fluxo de automação
Neste artigo você verá como é feita a construção do fluxo das conversas.
A tela de construção do fluxo tem balões de início e fim do chatbot e uma linha de conexões entre cada passo.
Confira as conexões, botões e formas de ativação do fluxo.
01. Veja os artigos disponíveis de Zenvia Docs
🌎 By Humanz for Humans: boas-vindas à Central de Ajuda da ferramenta Zenvia DocsNossa documentação é dividida em categorias:
1. Conceito e acesso: conceitos da ferramenta e orientações para acessá-la;
2. Primeiros passos: visão geral da ferramenta e etapas iniciais para uso;
3. Recursos e funções:
Como verificar as últimas ocorrências de uma regra
Ao acessar uma regra que já foi executada anteriormente, você verá no final das condições e critérios de ação uma seção chamada Últimas execuções:
Nessa seção nós mostramos todos os clientes atingidos anteriormente pela regra, quais dados haviam antes da execução da regra, e quais foram gravados
01. Contingência
A contingência é uma funcionalidade da Zenvia NLU cujo papel é impedir que os usuários fiquem sem atendimento caso entrem em contato com um canal onde o bot esteja apresentando problemas.
Quando isto ocorre, ela transfere todos os atendimentos para o atendimento humano configurado como contingência.
02. Referências técnicas (Biblioteca) para DEVs
Lembrando que as Expressions da biblioteca podem ser realizadas de diferentes formas e em diferentes momentos: como valor de variável, após uma chamada de API, após Webhook, como primeira validação, como segunda, em branchs, entre outros!
11. Opções de configuração da URA
A URA pode ser configurada pelo painel da plataforma de voz Zenvia, com as seguintes opções :
playAudio: Reproduz um áudio em MP3 (até 2 MB) através de uma URL. O link deve estar em modo público para funcionar corretamente.
playTTS: Reproduz um áudio a partir da leitura do texto inserido neste
03. Acompanhar o status da solicitação de template de WhatsApp
Após criar o seu template, ele será direcionado para análise do WhatsApp antes de estar disponível para ser utilizado. Isso ocorre para garantir que a mensagem não fere a Política do WhatsApp. Na plataforma Zenvia, é possível identificar o status do seu template. Para isso:
Acesse Produtos > Templat
15. Timer de sessão
Esta funcionalidade tem o objetivo de encerrar a sessão caso não haja resposta do usuário durante o tempo configurado dentro do fluxo.
Para acessar esta funcionalidade, entre na Plataforma de Comunicação da Zenvia: https://app.zenvia.com/ e informe suas credenciais.
Acesse o menu Produtos > Z
Integrar o Virtual Spirits ao atendimento comercial
Conecte seu chatbot criado no Virtual Spirits com o Zenvia Customer Cloud para importar conversas e leads automaticamente para o atendimento comercial. A integração permite que o histórico do chatbot seja carregado junto com cada lead, garantindo continuidade no atendimento.
Envio de Pesquisa de Satisfação do NLU para Movidesk
Este artigo detalha a configuração para enviar respostas de pesquisa de satisfação do sistema NLU diretamente para o Movidesk, integrando-as ao ticket correspondente. Isso permite a extração de relatórios, indicadores e a visualização das informações de satisfação dentro do próprio ticket no Movides
Agentes especialistas de suporte: o que são e como criá-los
Os agentes especialistas de suporte são automações configuráveis no Zenvia Customer Cloud que permitem executar ações automaticamente dentro de um ticket, sempre que condições específicas forem atendidas. Esses agentes podem ser acionados por interações dos usuários ou por regras temporais - como o tempo que um ticket permanece em determinado status. Com eles, é possível automatizar processos, reduzir tarefas manuais e padronizar o atendimento.
01. Veja os artigos disponíveis de Zenvia Chat
🌎 By Humanz for Humans: boas-vindas à Central de Ajuda do Zenvia ChatNossa documentação é dividida em três categorias:
Conceito e acesso: conceitos da ferramenta e orientações para acessá-la;Primeiros passos: visão geral da ferramenta e suas principais funcionalidades;Recursos e funções: manuais do
01. Outbound WhatsApp
ObjetivoO envio de outbound para integrações de WhatsApp poderá ser feito com templates, mídias ou texto.
API Outbound WhatsAppAo habilitar a API de outbound, é gerado um endpoint e um token que serão utilizados para realizar o envio das mensagens de outbound.
O envio será semelhante a API do WhatsA
10. Workplace
O Workplace Facebook é uma rede social que conecta todos os membros da sua empresa independente do local e lugar, disponibilizando recursos como: feed de notícias, eventos, arquivos, notificações e chat.
Compatibilidades
Input:
Texto
Output:
Texto
Arquivo
Feedback NPS
Quick Replies
Lista de opções
08. Upload de arquivo
Visão geralO componente file_upload permite que o usuário envie arquivos diretamente pelo Widget do NLU. Após o envio, o arquivo fica disponível no fluxo através do objeto input.file, contendo informações como nome, tamanho, tipo e URL de acesso.
Passo 1 – Exibir o componente de uploadEm uma etapa d
02. Integrações - API
Com a integração de API é possível criar um chat totalmente personalizado dentro de seu site ou app.
Para acessar essa funcionalidade vá em Zenvia Chat - Perfil de Administrador > Configurações > Integrações > API.
Para iniciar, basta clicar na aba API, no menu superior e em seguida, preencher os
01. Veja os artigos disponíveis de Zenvia Conversion
Boas-vindas à Central de Ajuda do Zenvia ConversionNesta página você encontra todas as documentações de uso do Zenvia Conversion, organizadas por categorias e temas mais populares.
Busque por informações e solucione suas dúvidas sobre os primeiros passos, nossos recursos e configurações gerais por a
API de atendimento comercial no Zenvia Customer Cloud
Importante: Antes de seguir com as instruções, confirme se a funcionalidade está disponível para o seu perfil de acesso.A API de Atendimento comercial foi desenvolvida para integrar leads ao Zenvia Customer Cloud de forma assíncrona, permitindo receber um webhook com seus resultados.
Saiba neste ar
05. Configurar o Aceite digital
Permita que seus clientes aceitem termos e assinem contratos com segurança e autenticação, em apenas alguns cliques.
Requisitos
Para utilizar a funcionalidade, considere os seguintes pontos:
A funcionalidade está disponível apenas para os canais e-mail ou SMS certificado;
É necessário o ter o Webho
01. Agent connector API
Objetivo
O Agent Connector API permite que plataformas externas realizem atendimentos de Live Chat no Zenvia NLU.
API Agent Connect
Esta API consiste no envio e recebimento de eventos, através de chamadas http. Diante disso, esteja atento às seguintes informações:
O Zenvia NLU enviará eventos para
01. Integração Messenger via Zenvia NLU
⚠️Atenção: Essa integração só pode ser feita em uma página comercial do Facebook
Para começar, acesse a página principal do Facebook e realize o login em sua conta pessoal.
A página comercial é criada dentro da sua conta pessoal no Facebook, desta forma, você será o administrador da página empres
05. Passos do fluxo
Neste artigo você irá entender como criar e qual a função de cada passo para a construção de um fluxo.
01. Integração de Zenvia Conversion com Zenvia Bots
Integre a sua conta Zenvia Bots com Zenvia Conversion para ampliar sua presença em diversos canais de conversação, construir fluxos de comunicação e automatizar as mensagens com seus clientes.
⚠️ Atenção: Para essa integração é necessário contratar a solução Zenvia Conversion e a ferramenta Zenvia B
03. Construindo um fluxo
Após selecionar a criação de um novo fluxo, você será redirecionado para o Bot Design, a tela de construção do fluxo das conversas.
A tela de construção do fluxo tem balões de início e fim do fluxo e uma linha de conexões entre cada passo.
Para começar a criar um bot clique no + e escolha os primeir
01. Criar automação
Este artigo te ensina os primeiros passos para construir suas automações e escolher os destinatários de forma rápida e intuitiva.
Para a criação de uma automação, há três opções:
Criar uma nova automação do zero;
Duplicar uma automação;
Criar uma nova versão da automação.
A seguir, detalhamos cada
Regras e definições de uso para WhatsApp
Neste artigo, conheça as regras da Meta sobre verificação da linha, modelos de mensagens, problemas no envio, qualidade do número, limite de mensagens (Tier) e janela de 24 horas - tudo organizado para facilitar seu uso no Zenvia Customer Cloud.
03. Exemplos no Ponto de Decisão / Branch
Antes de começarmos...
Para que você consiga executar as configurações a seguir, é sugerido dominar os conceitos de variáveis na Zenvia Bots (artigo) e principalmente o tratamento do Ponto de Decisão (artigo) durante as jornadas.
A dinâmica dos exemplos que serão mostrados estão atreladas a est