O correto funcionamento da integração requer que o ambiente Neppo esteja na versão mais recente e com o módulo de Webhooks ativo. Consulte seu representante Neppo para verificar e atualizar seu ambiente, se necessário.
1) Sobre a Neppo
A Neppo é um Omnichannel, plataforma multifuncional que centraliza todas as interações entre você e seus clientes! Com essa ferramenta, as empresas podem integrar e coordenar mensagens nos seguintes canais, diretamente via integração:
Canal de voz (chamadas telefônicas)
Whatsapp API
E-mails
Webchat
Instagram
2) Sobre a Integração
A integração Ploomes + Neppo conecta cadastros de clientes, comunicações de voz e WhatsApp diretamente ao CRM, automatizando o fluxo de atendimento e centralizando todas as interações em um só lugar.
2.1) Principais Funcionalidades
Chat embarcado – Interface de chat da Neppo integrada ao Ploomes com acesso direto a contatos, empresas e negócios e comunicação via voz, WhatsApp e e-mail.
Integração automática da baser de clientes – Sincronização automática de todos os contatos e empresas cadastrados no Ploomes para o Neppo, garantindo que a base de atendimento esteja sempre atualizada e unificada.
Automação de atendimento – Criação ou vinculação automática de cards de negócio no funil e envio ativo de mensagens WhatsApp conforme regras definidas no Ploomes
Histórico unificado – Registro automático de ligações, mensagens e interações no timeline do contato, empresa e negócio vinculado
Ações rápidas – Criação de contatos, negócios, tarefas, propostas e documentos diretamente do chat
Setup simplificado – Sincronização de cadastros e configuração plug-and-play para ativação imediata
2.2) Requisitos para a Integração
Para utilizar a integração Neppo + Ploomes, é necessário:
Conta Neppo ativa e configurada
Módulo de API contratado
Pelo menos 5 usuários no Ploomes
3) Ativando a integração!
3.1) Preparação para a integração
Antes de ativar a integração, configure seus usuários agentes na Neppo. Para que possam utilizar o chat embarcado no Ploomes é necessário:
Ser do tipo agente ou supervisor agente na Neppo
Ter o mesmo e-mail cadastrado na Neppo e no Ploomes
Caso exista mais de um e-mail cadastrado na Neppo, não será possível utilizar o chat embarcado no Ploomes.
Ao ativar a integração, todos os contatos que contenham telefone ou e-mail serão integrados com a Neppo. Caso o responsável pelo contato no Ploomes seja um agente integrado com a Neppo, ele será automaticamente vinculado ao cliente na Neppo.
3.2) Ativação pelo Ploomes
No Ploomes, acesse a tela de Integrações plug-and-play;
Procure por "Neppo" e clique na integração;
Clique em "Habilitar integração";
Clique em "Autorizar Integração";
Vá para seu ambiente Neppo para obter as credenciais de autorização:
Acesse a conta da Neppo em uma conta de Admnistrador;
Pesquise por “Integrações” na barra de pesquisa e acesse a página;
Clique em Em "Neppo Token API", clique em "Acessar";
Clique em "Criar Token";
Copie os valores das credenciais.
Preencha as informações obtidas na Neppo na tela de autenticação:
O campo 'URL da Neppo' deve ser preenchido com o link de acesso ao ambiente da Neppo, que geralmente segue o formato: "https://nomedaempresa.neppo.com.br/"
Na sessão de configurações da Integração, existe a opção "Vincular automaticamente novas sessões a negócio? se desejar automatizar a criação de cards de negócios ao iniciar uma sessão de atendimento. Para saber mais, acesse a documentação.
O mapeamento dos campos é fixo.
Clique em Ativar Integração;
Copie a url gerada;
3.3) Configurando o disparo de eventos e notificações do Neppo para o Ploomes
Para que a integração funcione corretamente, é necessário criar os seguintes webhooks na Neppo, utilizando a URL obtida ao ativar a integração no Ploomes.
Pesquise por “Webhooks” na barra de pesquisa da Neppo e acesse a página;
Na página de webhooks, clique no botão “Criar novo”;
Crie um webhook de usuário com as seguintes opções:
Tipo do webhook → Entidade;
Entidade → User;
URL: cole a url obtida ao ativar a integração no Ploomes.
Clique no botão “Salvar” e repita esses passos para os webhooks:
Webhook de Agente
Tipo do webhook: Entidade
Entidade: Agent
URL: cole a URL obtida ao ativar a integração no Ploomes.
Webhook de Classificação da Sessão
Tipo do webhook: Entidade
Entidade: ClassificationServices
URL: cole a URL obtida ao ativar a integração no Ploomes.
Webhook de Sessão de Atendimento
Tipo do webhook: Entidade
Entidade: ChatSession
URL: cole a URL obtida ao ativar a integração no Ploomes.
Webhook de Associação de Clientes com Agentes
Tipo do webhook: Entidade
Entidade: AssociationClientsToAgents
URL: cole a URL obtida ao ativar a integração no Ploomes.
4) Utilizando a Integração no Ploomes
Com a integração ativa, gerencie comunicações de voz e WhatsApp diretamente no Ploomes, centralizando todo o atendimento em uma única plataforma.
O Chat embarcado fica disponível no canto inferior direito da interface, proporcionando acesso imediato aos canais sem alternância entre sistemas.
4.1) Funcionalidades durante o atendimento
O Chat embarcado oferece recursos completos para gestão de atendimentos via Canal de Voz, WhatsApp e E-mail diretamente no Ploomes. As funcionalidades disponíveis variam conforme o status de cadastro do cliente.
Os atendimentos serão direcionados aos agentes conforme as regras que foram configuradas na Neppo.
Caso esteja configurado na Neppo o encerramento por inatividade, a sessão será encerrada no Ploomes após o período definido.
Criar ou vincular contato
Caso o contato não exista no Ploomes, é possível criar um novo ou vinculá-lo a um existente diretamente do chat embarcado. Ao ter um contato vinculado no Ploomes, é possível seguir com outras ações.
Criar ou vincular sessão de atendimento a um negócio
É possível configurar a integração para criar automaticamente um novo negócio sempre que uma nova sessão for iniciada. Além disso, é possível vincular a sessão a um negócio existente ou criar um novo diretamente pelo chat embarcado.
Observação: o contato precisa estar cadastrado como cliente do negócio, contato do negócio ou contato da empresa do negócio para que o negócio apareça na lista de vínculos possíveis.
Visualizar contato, empresa e negócio
Para visualizar o perfil do contato, clique no ícone de cliente vinculado ao lado do nome
Para acessar a empresa, clique no nome dela abaixo do contato
Para acessar o negócio, clique no nome do negócio vinculado à sessão
Criação de Tarefas, Documentos, Propostas e Vendas
Durante o atendimento via chat embarcado, o agente pode criar tarefas, documentos, propostas e vendas diretamente da conversa, sem precisar sair da interface do chat. Essas ações ficam disponíveis ao clicar no botão "Novo", que aparece quando somente o contato existe na Ploomes.
As ações de criação só ficam disponíveis quando a sessão está vinculada a um cliente no Ploomes.
Os registros criados são automaticamente relacionados à sessão ativa e ao ultimo agente que realizou atendimento naquela sessão.
Criação de Tarefas
Permite acessar o modal de criação de tarefas para registrar pendências ou follow-ups diretamente da conversa.
As tarefas são vinculadas ao negócio e cliente da sessão.
Caso o contato tenha uma empresa, a empresa dele é preenchida no campo de "Cliente" e o contato é inserido em "Contatos Relacionados" da tarefa.
Criação de propostas, vendas e documentos
Permite acessar a criação de documentos, vendas e propostas a partir do chat de atendimento.
Observações:
Requer permissão de criação da proposta, venda ou documento no Ploomes, além de ter o módulo contratado no Ploomes.
A proposta sempre deve estar associada a um negócio. Se o contato não estiver vinculado a um negócio, será redirecionado para a página de criação de negócio e proposta conjunta.
O documento é salvo automaticamente no contexto do cliente e do negócio.
Essas funcionalidades tornam o chat embarcado um ponto central de operação, permitindo que o agente conclua etapas do processo comercial sem sair do atendimento.
Comentários
É possível adicionar multiplos comentários durante um atendimento, de mensagem ou ligação. Eles ficam disponíveis no histórico da conversa disponível no registro de interação.
Transferência de atendimento
Essa funcionalidade permite que um agente/usuário transfira a conversa para outro agente, direto pela interface da Neppo integrada ao Ploomes. A transferência é feita com facilidade, permitindo que informações e histórico de interações sejam compartilhados, garantindo uma transição suave e a continuidade no atendimento ao cliente, para tal seguir como no vídeo abaixo:
Além disso, também é possível transferir atendimentos de ligação entre agentes, para isso basta, digitar no teclado numérico asterisco, um e o número do ramal desejado (* + 1 * ramal).
Quando mais de um usuário/agente atua em uma mesma sessão e essa sessão é salva no Ploomes, o registro de interação trará as informações trocadas com ambos os agentes.
Encerramento da sessão e classificação
É possível clicar nos ⋮ e clicar para finalizar a sessão. Ao finalizar a sessão, caso o grupo de atendimento esteja configurado para isso, será necessário fazer uma classificação do atendimento. Esta classificação é visível no registro de interação da sessão e o comentário fica salvo.
Salvamento da sessão
O salvamento é automático e ocorre no início da sessão, registrando o atendimento no histórico do contato, além de empresa e negócio caso existam. Comentários feitos durante o atendimento, grupo de atendimento, anexos e a classificação ficam automaticamente salvos no registro de interação.
4.2) Ações Disponíveis na tela inicial
Pausar Sessão
Ative a pausa para interromper temporariamente os atendimentos dirigidos ao agente. As pausas configuradas na Neppo aparecerão. Para retomar as atividades, aguarde o tempo estipulado ou reative a sessão pelo símbolo de play, e depois em "Retomar Sessão".
Neppo Voz
Inicie ligações diretamente através do chat embarcado ao selecionar o ícone de telefone e inserir o número do cliente.
Observação: Caso seja uma ligação nacional, não insira o DDI (+55) no teclado. Caso o DDD do número que será chamado seja o mesmo DDD que o seu, não insira no teclado
Classificação de Atendimento
Avalie os atendimentos concluídos, a partir das regras criadas na Neppo, utilizando o contador para identificar quantos ainda necessitam de classificação.
Envio ativo
Inicie novas conversas de WhatsApp com seus clientes! Selecione o cliente desejado, escolha o grupo de atendimento e o canal, e então envie a mensagem conforme as configurações estabelecidas. É necessário ter modelos de mensagem previamente configurados na Neppo e aprovados pela Meta.
Para que o cliente apareça como um atalho pro agente na lista de envios ativos, é necessário que ele já tenha sido atendido pelo próprio agente ou por um de seus grupos de atendimento.
Barra de pesquisa e abas de navegação
Realize buscas de atendimentos utilizando o número de telefone ou nome do cliente em diferentes abas:
Em andamento: Sessões em andamento.
Encerrados: Sessões finalizadas.
Ativos: Listagem de envios ativos efetuados. Quando um envio ativo é respondido pelo contato, ele vira uma sessão em andamento.
5) Casos de Uso
5.1) Automação de envio ativo de WhatsApp
Também é possível fazer envio ativo de mensagens de Whatsapp via Neppo através de automações do Ploomes (seja genérica ou de funil) para disparar mensagens de forma automática, seguindo condições previamente definidas.
Essa funcionalidade garante agilidade na comunicação com clientes, fortalece o relacionamento e otimiza processos comerciais.
Saiba mais no artigo sobre esta funcionalidade!
5.2) Criação automática de card ao início da sessão de atendimento
É possível configurar a integração para que ao iniciar uma sessão de atendimento, o sistema crie ou vincule automaticamente um card no funil do Ploomes, agilizando o processo comercial, reduzindo erros e aumentando a produtividade da equipe.
Saiba mais no artigo sobre esta funcionalidade!
5.3) Gestão de carteira
Por padrão, sempre que o responsável por um cliente na Ploomes for um agente na Neppo, ele será automaticamente associado a esse cliente na Neppo. Além disso, é possível vincular outros agentes ao cliente seguindo as etapas abaixo:
Essa configuração só funcionará caso os webhooks de sua conta estejam corretamente configurados.
Acesse a tela de “Campos e formulários”
Edite o formulário de Pessoas e adicione o campo "Agentes (Neppo)”
Acesse o cadastro do cliente que deseja associar a mais agentes e procure pelo campo "Agentes (Neppo)", adicione os usuários desejados.
Estes usuários estarão vinculados ao cliente no ambiente da Neppo e as configurações do fluxo de atendimento que dependam deste vínculo funcionarão corretamente de acordo com o vínculo configurado diretamente pela Ploomes.
6) Informações adicionais e boas práticas
6.1) Integridade dos Números de Telefone
O número de telefone funciona como chave primária na Neppo e deve estar completo e padronizado para garantir o correto funcionamento da integração.
Formato obrigatório:
DDI + DDD + Número
Exemplo para o Brasil: 55 11 99999-9999
Não é obrigatório colocar o "+" antes do DDI. Preferencialmente, utilize as máscaras de telefone do Ploomes para garantir uma formatação correta.
Validação automática:
Todos os números passam por validação da Neppo. Caso um contato não atenda aos requisitos, será criado um registro de interação informando o motivo da falha e solicitando atualização dos dados daquele contato.
Dica: Mantenha os cadastros de telefone sempre atualizados e completos para evitar falhas na sincronização e nas funcionalidades de comunicação.
6.2) Máscaras de Telefone no Ploomes
O Ploomes suporta máscaras de telefone para alguns países, enviando-as para a Neppo.
Recomendação: Utilize as máscaras para garantir consistência nos dados.
Caso a máscara não seja utilizada, insira manualmente o DDI no campo de telefone.
6.3) Atenção às Integrações de Criação de Contatos
Verifique se as integrações que criam contatos no Ploomes estão gerando dados completos.
Problemas podem ocorrer se o formulário associado às integrações não estiver configurado corretamente.
Sugestão: Configure os formulários para tornar o preenchimento do DDI obrigatório, garantindo informações completas.
6.4 Disponibilidade para envio ativo
Um cliente/contato só aparecerá para o agente em dois cenários:
Quando um cliente entrou em contato com algum grupo de atendimento que aquele agente está vinculado (ou seja, o cliente mandou umas mensagem para o grupo de suporte, por exemplo. Neste caso, o cliente aparecerá na lista de envio ativo para todos os agentes vinculados ao grupo de suporte)
Quando o agente no Ploomes é o usuário responsável por aquele cliente/contato da empresa.
6.5 Requisitos para Agentes
Para integração com o Ploomes, certifique-se de que:
O usuário possui perfil de agente ou supervisor de agentes na Neppo
O mesmo e-mail está cadastrado em ambas as plataformas
O chat token foi gerado na Neppo
Cada e-mail é único no sistema Neppo (sem duplicatas)
7) FAQ da Integração
1. O que é necessário para o correto funcionamento da integração?
O ambiente da Neppo deve estar na versão mais recente e com o módulo de Webhooks ativo. Os agentes devem estar configurados corretamente e ter o mesmo e-mail que o Ploomes. Caso tenha dúvidas, entre em contato com a equipe de suporte.
2. O que é a Neppo?
A Neppo é uma plataforma Omnichannel que centraliza comunicações com clientes por diversos canais (Voz, WhatsApp, E-mail, Instagram, entre outros). Com a integração, é possível gerenciar essas interações diretamente no Ploomes.
3. O que faz a integração Ploomes + Neppo?
Conecta cadastros de clientes, chamadas de voz e mensagens WhatsApp diretamente ao Ploomes, automatizando atendimentos e centralizando registros em um só lugar.
4. Quais são as principais funcionalidades?
Chat embarcado com comunicação via Voz, WhatsApp e E-mail.
Criação ou vinculação automática de negócios e envio ativo de mensagens WhatsApp.
Histórico unificado de ligações, mensagens e interações.
Ações rápidas (criar contatos, tarefas, propostas e documentos).
Setup plug‑and‑play com sincronização de cadastros.
5. Quais são os requisitos para utilizar a integração?
Conta Neppo ativa e configurada.
Piso de 5 usuários no Ploomes.
Módulo de API contratado no Ploomes.
6. Como ativar a integração?
Configure os usuários/agentes na Neppo com o mesmo e-mail usado no Ploomes.
No Ploomes, acesse Integrações Plug‑and‑Play → procure por Neppo → clique em Habilitar → Autorizar Integração.
No ambiente Neppo, gere o Token de API e copie as credenciais.
Preencha no Ploomes o campo URL da Neppo (ex.:
https://nomedaempresa.neppo.com.br/).Configure a opção Vincular automaticamente novas sessões a negócio (se desejar).
Clique em Ativar Integração e copie a URL gerada.
Configure os webhooks na Neppo com essa URL.
7. Quais webhooks precisam ser criados na Neppo?
Crie os seguintes, sempre com o tipo Entidade e a URL obtida ao ativar a integração:
UserAgentClassificationServicesChatSessionAssociationClientsToAgents
8. Onde encontro o Chat embarcado no Ploomes?
No canto inferior direito da interface do Ploomes, somente para usuários integrados. Para consultar se um usuário está corretamente integrado no Ploomes, basta
9. Quais ações posso realizar durante o atendimento?
Criar ou vincular contatos e negócios.
Criar tarefas, propostas, documentos e vendas.
Adicionar comentários e classificar atendimentos.
Transferir conversas entre agentes.
10. Como funciona o salvamento das sessões?
O salvamento é automático, ocorrendo no início da sessão. As informações são registradas no histórico do contato, empresa e negócio vinculados.
11. É possível integrar chatbots da Neppo ao Ploomes?
Sim. Chatbots configurados na Neppo funcionam normalmente em conversas via WhatsApp API dentro do Ploomes.
12. Há automações adicionais disponíveis?
Sim. É possível automatizar o envio ativo de mensagens WhatsApp e a criação automática de negócios no início das sessões, conforme as regras configuradas no Ploomes.
13. O que é o campo “Agentes vinculados”?
Esse campo permite associar agentes Neppo a clientes no Ploomes para fins de gestão de carteira. Para utilizá-lo, adicione o campo Agentes (Neppo) ao formulário de Pessoas e configure os vínculos necessários.
14. O que devo fazer se o funil ou webhook for removido?
Se o funil ou webhook estiver ausente ou desativado, a criação automática de cards e o registro de interações serão interrompidos. Reconfigure o webhook ou o mapeamento para restabelecer o vínculo.
Acesse a Universidade Ploomes para saber mais
A Ploomes disponibiliza uma plataforma de educação digital criada para capacitar seus clientes, oferecendo uma variedade de cursos, shorts, casos de uso e webinars.
Abaixo você confere uma sugestão de conteúdo disponível em nossa plataforma que se relaciona ao tema deste artigo.
