Aplicativos, Integrações e API

7 artigos R Por Ruan Rodrigues

Aplicativos do painel, integrações, webhooks e API para conectar a NexaOmni a outros sistemas.

O que são os Aplicativos do Painel

O que são os Aplicativos do Painel Os Aplicativos do Painel permitem exibir um sistema externo seu dentro da tela de atendimento do NexaChat, sem precisar trocar de janela. Eles aparecem em formato de mini-página (iframe) durante a conversa ou na ficha do contato. Onde eles aparecem Você pode escolher em qual área o aplicativo é exibido: Tipo Onde aparece Painel de Conversa Na barra lateral, durante o atendimento de uma conversa Painel de Contato Na ficha do contato Para que serve Alguns exemplos práticos: - Mostrar dados de um CRM externo direto na conversa. - Exibir os pedidos do cliente vindos do seu e-commerce. - Disponibilizar calculadoras ou ferramentas internas (financiamento, frete). - Apresentar formulários personalizados para o usuário preencher. - Integrar sistemas legados da empresa. Ele recebe os dados do cliente automaticamente? Sim. Ao abrir, o aplicativo recebe automaticamente as informações do atendimento em andamento, como ID do contato, nome, e-mail, telefone, atributos personalizados e dados da conversa atual. O seu sistema usa esses dados para exibir a informação certa, e a comunicação funciona nos dois sentidos: o aplicativo interage com a plataforma e vice-versa. Observação: montar o aplicativo exige um sistema seu que responda em uma URL (página web). Se precisar de ajuda para essa parte técnica, fale com a nossa equipe. Para aprender a cadastrar um aplicativo, veja o artigo Como criar um Aplicativo do Painel.

Como criar um Aplicativo do Painel

Como criar um Aplicativo do Painel Um Aplicativo do Painel exibe um sistema seu (em formato de mini-página) dentro da tela de atendimento. Siga os passos abaixo para cadastrar um. Passo a passo 1. Abra as Configurações da conta (menu lateral, ícone de engrenagem). 2. Acesse a área de Integrações. 3. Clique em configurar em Painel de Aplicativos. 4. Informe os dados solicitados: - Nome do aplicativo (como ele será identificado no painel). - URL da página do seu sistema que será carregada dentro do NexaChat. - Onde deve aparecer: no Painel de Conversa (durante o atendimento) ou no Painel de Contato (na ficha do contato). 5. Salve. Pronto. A partir daí, o aplicativo passa a aparecer na área escolhida e recebe automaticamente os dados do contato e da conversa. Dica: teste a URL do seu sistema no navegador antes de cadastrar, para garantir que ela abre normalmente. Observação: o caminho exato dessa tela pode variar conforme a sua conta. Se não encontrar a opção Aplicativos nas configurações, fale com a nossa equipe.

Integrações disponíveis no NexaChat

Integrações disponíveis no NexaChat O NexaChat conecta-se a diversos sistemas externos para trazer mais dados e automação para o seu atendimento. Abaixo estão as integrações disponíveis. Integração O que faz Provedor de IA Motor de inteligência artificial usado pela NexaAI (sugestões, resumo, reescrita e mais) Shopify Mostra pedidos e dados do cliente da loja durante a conversa WooCommerce Traz o histórico de pedidos do cliente para o contexto do chat Slack Recebe notificações e permite responder a partir do Slack Dialogflow Robôs de linguagem natural do Google nas caixas de entrada Google Tradutor Tradução automática de mensagens Chamadas de vídeo e voz Videochamadas e ligações com o cliente Notion Conecta um workspace do Notion como base de conhecimento da NexaAI Linear Cria tarefas (issues) a partir das conversas LeadSquared Sincroniza contatos com o CRM Webhooks Envia eventos em tempo real para sistemas externos Aplicativos do Painel Mini-páginas personalizadas dentro da interface API REST Integração total via API Como ativar uma integração 1. Abra as Configurações da conta (menu lateral, ícone de engrenagem). 2. Acesse a área de Integrações. 3. Escolha a integração desejada na lista. 4. Siga o fluxo próprio de cada uma — algumas pedem conexão via login (OAuth), outras pedem credenciais/chaves. NexaAI: ao ativar o provedor de IA, os recursos assistidos da NexaAI passam a funcionar — sugestão de resposta, resumo, reescrita, verificação ortográfica e sugestão de etiquetas. Observação: o caminho exato da tela de Integrações pode variar conforme a sua conta. Se não encontrar a opção, fale com a nossa equipe.

Como criar um Webhook

Como criar um Webhook Um Webhook avisa o seu sistema, em tempo real, sempre que algo acontece no NexaChat (uma nova conversa, uma nova mensagem, uma mudança de status, etc.). É a forma mais rápida de manter outro sistema sincronizado com o seu atendimento. Passo a passo 1. Abra as Configurações da conta (menu lateral, ícone de engrenagem). 2. Acesse Integrações e localize a opção Webhooks. 3. Clique em Novo Webhook. 4. Informe: - URL de destino: o endereço do seu sistema que vai receber os eventos. - Eventos que deseja receber. 5. Salve. Quais eventos posso receber - Criação de conversa - Nova mensagem - Atualização de conversa - Mudança de status - Atribuição de usuário - Criação/atualização de contato - Atualização de robô (Agent Bot) - Entre outros O envio inclui os anexos? Sim. Quando a mensagem tem anexo, o envio traz o tipo do arquivo (content_type) e a extensão, além de links seguros e temporários para download. Observação: o caminho exato até os Webhooks pode variar conforme a sua conta. Se não encontrar a opção, fale com a nossa equipe.

API REST e token de acesso

API REST e token de acesso O NexaChat tem uma API REST completa, que permite integrar a plataforma a qualquer sistema seu de forma automatizada. O que dá para fazer pela API - Enviar e receber mensagens - Criar e atualizar contatos - Gerenciar conversas - Criar registros no funil (Kanban) - Gerenciar campanhas - E muito mais Onde está a documentação A documentação técnica da API fica em https://docs-api.nexaomni.com.br/. Você também pode solicitar o documento em PDF à nossa equipe de suporte. Como obter o token de acesso por usuário Cada usuário tem o seu próprio token de acesso, usado para autenticar as chamadas à API. Para encontrá-lo: 1. Abra o seu Perfil (clique no seu avatar). 2. Acesse Configurações do perfil. 3. Localize a seção Token de Acesso e copie o valor. Segurança: o token dá acesso à conta em nome do usuário. Nunca compartilhe o token publicamente nem o inclua em páginas visíveis ao cliente. Se suspeitar que ele vazou, gere um novo. Precisa de ajuda com a integração? Fale com a nossa equipe.

Como instalar o NexaChat no n8n

Como instalar o NexaChat no n8n Com os nodes do NexaChat no n8n, você automatiza o seu atendimento: cria contatos, envia mensagens, move cards no Kanban, usa a NexaAI, responde comentários do Instagram, recebe respostas de formulários e acompanha seus anúncios — tudo dentro dos seus fluxos. Antes de começar - n8n instalado no seu servidor (self-hosted), versão 1.x ou 2.x. - Acesso de dono (owner) da instância do n8n. - Um usuário do NexaChat com acesso ao que você vai automatizar. Importante: o n8n Cloud (a versão hospedada pelo próprio n8n) ainda não permite instalar estes nodes. Use o n8n instalado no seu servidor. Passo 1 — Instalar os nodes 1. No n8n, abra Settings (Configurações) → Community Nodes. 2. Clique em Install. 3. No campo npm Package Name, digite: @nexaomni/n8n-nodes-nexachat 4. Marque "I understand the risks…" e clique em Install. Tela Install community nodes do n8n com o pacote @nexaomni/n8n-nodes-nexachat preenchido Pronto. Ao adicionar um passo no fluxo, busque por NexaChat para ver todos os nodes. Busca por NexaChat ao adicionar um passo no fluxo do n8n Usa n8n com Docker em modo fila (main + workers)? A instalação vale para todos os processos se eles compartilham a pasta /home/node/.n8n. Se não compartilham, defina N8N_REINSTALL_MISSING_PACKAGES=true nos workers. Passo 2 — Conectar a sua conta 1. Em qualquer node do NexaChat, no campo Credential, clique em Create new credential. 2. Preencha: - NexaChat API URL: https://chat.nexaomni.com.br - Access Token: o token de acesso do seu usuário. Para encontrá-lo, abra o seu Perfil (clique no seu avatar) → Configurações do perfil → seção Token de Acesso → clique em Copiar. 3. Salve. O n8n testa a conexão na hora. Onde copiar o token, no seu perfil do NexaChat: Seção Token de acesso nas Configurações do perfil do NexaChat, com o botão Copiar Credencial salva e testada no n8n: Credencial do NexaChat no n8n com a mensagem Connection tested successfully Restringiu os domínios da credencial? No n8n 2.x a credencial tem a opção Allowed HTTP Request Domains. Se você limitar os domínios, inclua os dois: chat.nexaomni.com.br e engagement.nexaomni.com.br (o segundo é usado pelos nodes de Instagram, Formulários e Anúncios). Qual usuário usar? O n8n age como o usuário dono do token: tudo o que o fluxo fizer aparece no NexaChat em nome desse usuário, com as mesmas permissões dele. Recomendado: crie um usuário só para integrações (por exemplo, "Integração n8n") com perfil de administrador. Assim as mensagens automáticas ficam identificadas e nada para de funcionar se alguém da equipe sair da empresa. Ler respostas de formulários exige token de administrador. O que cada node faz Node Para que serve NexaChat Conversas, mensagens, contatos, empresas, etiquetas, caixas de entrada, Kanban, tarefas, agenda, campanhas, respostas prontas, Central de Ajuda, relatórios e NexaAI NexaChat Trigger Inicia o fluxo quando algo acontece no NexaChat: nova mensagem, conversa criada ou atualizada, contato criado e outros NexaChat Instagram Comentários (listar, responder, DM ao autor, ocultar, resolver), leads, posts (agendar, listar, métricas), envio de imagem/vídeo e crescimento da conta NexaChat Instagram Trigger Inicia o fluxo a cada novo comentário ou novo lead do Instagram NexaChat Forms Lista seus formulários de captura e as respostas recebidas NexaChat Forms Trigger Inicia o fluxo a cada nova resposta de formulário NexaChat Ads Resultados das campanhas, gasto × vendas, funil, origem dos leads e envio de conversões para a Meta NexaChat Ads Trigger Inicia o fluxo quando chega um novo lead vindo de anúncio Os nodes de Instagram, Formulários e Anúncios funcionam quando o módulo correspondente está contratado e ativo na sua conta. Exemplos de automação - Lead do formulário → WhatsApp em segundos: NexaChat Forms Trigger → NexaChat (criar contato) → NexaChat (enviar mensagem). - IA respondendo comentários do Instagram: NexaChat Instagram Trigger → NexaAI ou outra IA → NexaChat Instagram (responder e enviar DM). - Venda no seu sistema → a Meta aprende quem compra: Webhook do seu ERP/checkout → NexaChat Ads (Enviar conversão: Purchase com o valor e o número do pedido). Exemplo simples — cada novo comentário recebe uma resposta pública (no campo Comment ID use a expressão {{ $json.comment_id }}): Fluxo no n8n: NexaChat Instagram Trigger ligado ao node Reply publicly to a comment Usando IA para responder comentários? Desligue as regras de palavra-chave do NexaChat na mesma conta do Instagram — senão o comentário recebe duas respostas. No gatilho, deixe ligada a opção Ignore Own Comments para a IA não responder os comentários da sua própria marca. Segurança - O token dá ao n8n o mesmo acesso do usuário. Nunca compartilhe nem cole o token em lugares públicos. - Para cortar o acesso, gere um novo token no perfil do NexaChat — o anterior deixa de funcionar. - Ações que publicam (responder comentário, DM, agendar post, enviar mensagem) são reais: teste com contatos seus antes de ativar o fluxo. Atualizações Quando sair uma versão nova, vá em Settings → Community Nodes, localize @nexaomni/n8n-nodes-nexachat e clique em Update. Precisa de ajuda com a automação? Fale com a nossa equipe.

Integração com o Bling: dados do cliente, pedidos, boletos, notas e estoque no atendimento

A integração com o Bling traz as informações do seu ERP para dentro da conversa. Sua equipe e a NexaAI podem consultar dados do cliente, pedidos, cobranças, notas fiscais e estoque sem sair do atendimento. A integração só lê dados do Bling. Ela não cria nem altera nada na sua conta Bling. O que a integração faz Painel Cliente Bling na conversa No painel lateral da conversa, na seção Bling, você encontra duas abas: Cliente e Estoque. Aba Cliente - Identifica o cliente automaticamente pelo CPF/CNPJ ou pelo telefone do contato. - Mostra os pedidos com a situação, os itens e o código de rastreio (quando cadastrado no Bling). - Mostra a nota fiscal do pedido, com link para o DANFE. - Lista as cobranças em aberto, com os botões Boleto e PIX (quando o boleto ou o PIX foi gerado pelo Bling). - Permite buscar manualmente o cliente e confirmar o vínculo. Aba Estoque - Busque produtos por nome ou código (SKU). - Veja o preço e o saldo por depósito, além do total. Recursos da NexaAI A NexaAI pode usar o Bling para responder seus clientes. Em Configurações → Integrações → Bling → Configurar, você liga ou desliga cada recurso: - Consultar estoque - Pedidos do cliente - Segunda via de boleto - Notas fiscais Os recursos valem para todos os assistentes da conta. Antes de começar - Você precisa de uma conta ativa no Bling com permissão para autorizar aplicativos. - Na NexaOmni, a conexão deve ser feita por um administrador da conta. Passo a passo: conectar o Bling 1. Abra Configurações → Integrações e localize o card Bling Na NexaOmni, acesse Configurações → Integrações e encontre o card Bling. Tela Configurações → Integrações com o card do Bling em destaque 2. Clique em Configurar e depois em Conectar No card do Bling, clique em Configurar. Com a integração desconectada, a janela mostra o status Desconectado e o botão Conectar. Clique nele. Janela Integração Bling com status Desconectado e o botão Conectar 3. Autorize no Bling Você será levado ao Bling. Faça login, se necessário, e clique em Autorizar. Depois disso, você volta automaticamente para a NexaOmni. A conexão é feita de forma segura pelo próprio Bling. A NexaOmni não pede nem armazena sua senha. 4. Confira a conexão e escolha os Recursos da NexaAI De volta à NexaOmni, o card aparece como Conectado e a janela mostra a conta Bling conectada. Em Recursos da NexaAI, ligue ou desligue o que a NexaAI pode consultar: Consultar estoque, Pedidos do cliente, Segunda via de boleto e Notas fiscais. Janela da integração conectada, com a conta Bling e os recursos da NexaAI Quais permissões o aplicativo pede O aplicativo pede acesso de leitura a: clientes, pedidos, contas a receber, notas fiscais, estoque, produtos, depósitos e dados da empresa. Ele não tem permissão para criar ou alterar informações. Passo a passo: usar o Bling no atendimento 5. Veja o cliente na conversa (seção Bling, aba Cliente) Abra uma conversa. No painel lateral, na seção Bling, a aba Cliente mostra o cliente identificado (por exemplo, Automático · telefone) e os Pedidos recentes. Painel lateral da conversa com a seção Bling, aba Cliente, mostrando o cliente e os pedidos recentes 6. Expanda um pedido Clique em um pedido para ver os itens, o rastreio (com botão Copiar) e a nota fiscal, com o botão DANFE. Pedido expandido mostrando itens, rastreio e nota fiscal com DANFE 7. Consulte as cobranças em aberto Mais abaixo, em Títulos em aberto, aparecem as cobranças com o vencimento, o valor e a situação. Quando o boleto ou o PIX foi gerado pelo Bling, os botões Boleto e PIX ficam disponíveis. Títulos em aberto com os botões Boleto e PIX 8. Cliente com mais de um cadastro Se houver mais de um cadastro no Bling com o mesmo telefone, o painel mostra Mais de um cliente possível. Escolha o correto clicando em É este. Se nenhum for o certo, use Nenhum destes? Buscar no Bling. Painel com dois clientes possíveis e os botões É este 9. Corrija o vínculo: Não é este cliente e busca manual Se o cliente identificado estiver errado, clique em Não é este cliente. O painel passa a mostrar um campo de busca: digite o nome, o CPF/CNPJ ou o código (mínimo de 3 caracteres). Painel com o aviso de que o cliente foi marcado como não sendo do Bling e o campo de busca Encontre o cadastro certo na lista e clique em Vincular. Para trocar de cliente a qualquer momento, use também o link Trocar. Resultado da busca manual com o botão Vincular 10. Consulte o estoque Na aba Estoque, busque por nome ou SKU. Aparecem o preço, o total em estoque e o saldo por depósito. O botão Inserir na resposta coloca a informação na mensagem que você está escrevendo. Aba Estoque com a busca por camisa, preço, saldo total e saldo por depósito 11. Veja a NexaAI respondendo Com os recursos ligados e o cliente identificado, a NexaAI responde sozinha, usando só os dados do cliente da conversa. Exemplo: situação dos pedidos e rastreio. NexaAI informando ao cliente a situação dos pedidos e o rastreio E a segunda via de boleto, com a explicação quando não há link disponível para uma cobrança. NexaAI informando as cobranças em aberto e enviando os links de boleto e PIX Se as ferramentas do Bling não aparecerem na lista de ferramentas do seu assistente, confira se a integração está Conectada e se o recurso correspondente está ligado em Configurações → Integrações → Bling → Configurar. Persistindo, fale com a equipe NexaOmni. Exemplo de cenário para a NexaAI Para orientar a NexaAI no pós-venda, crie um cenário no seu assistente em NexaAI → Cenários → Adicionar um cenário. No campo Como lidar, as ferramentas são chamadas digitando @ e escolhendo a ferramenta na lista que aparece. Ela vira uma menção destacada no texto (por exemplo, @bling_meus_pedidos) e fica vinculada ao cenário. As ferramentas do Bling são: - @bling_consultar_estoque: consulta o preço e o saldo de produtos (total e por depósito). - @bling_meus_pedidos: consulta os pedidos do cliente da conversa, com a situação e o rastreio. - @bling_segunda_via: consulta as cobranças em aberto, com os links de boleto e PIX. - @bling_nota_fiscal: consulta as notas fiscais dos pedidos, com o link do DANFE. Use o texto abaixo como modelo e adapte ao seu negócio: Título: Pós-venda (Bling) Descrição: Cliente pergunta sobre pedido, entrega, rastreio, boleto, segunda via ou nota fiscal. Como lidar: 1. Para status de pedido, entrega ou rastreio, use @bling_meus_pedidos. 2. Para boleto, PIX, vencimento ou segunda via, use @bling_segunda_via. 3. Para nota fiscal ou DANFE, use @bling_nota_fiscal. 4. Para disponibilidade ou preço de produto, use @bling_consultar_estoque. 5. Responda só com o que a ferramenta trouxer, de forma curta e cordial; envie os links quando houver. 6. Se a ferramenta disser que não identificou o cadastro, não peça CPF nem outros dados: diga que vai transferir e transfira para um atendente. Atenção ao colar: texto colado não vira menção. Depois de colar, apague cada @ferramenta e insira de novo: digite @ e escolha a ferramenta na lista do editor. Ao salvar, o cenário mostra as ferramentas vinculadas em Ferramentas usadas. O cenário preenchido, com as ferramentas inseridas por @ (em destaque), fica assim: Tela de criação de cenário com o título, a descrição e as instruções de pós-venda, com as ferramentas do Bling inseridas por @ E a NexaAI usando o cenário: o cliente pergunta "Cadê meu pedido?" e ela responde com o pedido e o rastreio consultados no Bling. Conversa em que o cliente pergunta Cadê meu pedido? e a NexaAI responde com o pedido mais recente e o código de rastreio Como o cliente é identificado - Automático: a NexaOmni procura no Bling o cadastro que corresponde ao CPF/CNPJ do contato ou, se não houver, ao telefone. - Mais de um cadastro com o mesmo telefone: o atendente escolhe qual é o cliente correto. - Vínculo manual: use a busca no painel, encontre o cliente e clique em Vincular (ou em É este, quando o painel já sugere os cadastros). Se o cadastro sugerido estiver errado, clique em Não é este cliente. Segurança e privacidade - A NexaAI só informa dados do cliente identificado na própria conversa. - A NexaAI nunca libera pedidos, boletos ou notas a partir de um CPF digitado na mensagem. Isso evita que alguém consulte dados de outra pessoa. - Se o cliente não puder ser identificado, a NexaAI transfere o atendimento para uma pessoa da sua equipe. Desconectar ou reconectar - Para desconectar, acesse Configurações → Integrações → Bling e clique em Desconectar. - Se o card aparecer como Expirado, clique em Conectar novamente e autorize no Bling. Isso pode acontecer se a autorização for revogada no Bling ou ficar muito tempo sem uso. Dúvidas frequentes A NexaAI não encontrou o cadastro do cliente, e agora? Confira se o contato tem o CPF/CNPJ ou o telefone igual ao do cadastro no Bling. Se não tiver, o atendente pode usar a busca manual no painel e clicar em Vincular. Sem identificação, a NexaAI transfere a conversa para um atendente. Por que não aparece o botão de boleto? Os botões Boleto e PIX só aparecem quando o boleto ou o PIX foi gerado pelo Bling para aquela cobrança. Se a cobrança foi feita por outro meio, gere o boleto no Bling. Por que não aparece o rastreio? O código de rastreio precisa estar cadastrado no volume/transporte do pedido no Bling. Os dados ficam atualizados? Os clientes são sincronizados automaticamente. Pedidos, cobranças e notas são consultados na hora, com atualização a cada poucos minutos. Se algo não bater com o Bling, aguarde alguns minutos e consulte novamente. Posso desligar um recurso? Sim. Em Configurações → Integrações → Bling → Configurar, desligue qualquer um dos recursos da NexaAI (estoque, pedidos, boleto ou notas) quando quiser. Desconectar apaga o quê? A desconexão remove a conexão e os dados de clientes sincronizados na NexaOmni. Nada é apagado no Bling. O nome da situação do pedido aparece diferente do Bling. Situações personalizadas criadas no Bling podem aparecer com o nome padrão. Consigo alterar estoque, preço ou pedidos pela NexaOmni? Não. A integração apenas consulta os dados. Alterações continuam sendo feitas no Bling. Tenho mais de um depósito. Aparecem todos? Sim. O saldo é exibido por depósito e também o total. Precisa de ajuda? Fale com a equipe NexaOmni pelo WhatsApp (27) 3199-1998 ou pelo chat da plataforma.