Nvoip · Base de Conhecimento

Como integrar a OLX à Nvoip e configurar o atendimento

Última atualização: 08/09/2026

A integração OLX com a Nvoip conecta sua conta anunciante ao atendimento e permite direcionar os eventos disponíveis para a equipe responsável. A configuração tem três etapas: autorizar a conta em Integrações, escolher Conversas ou Leads no Fluxo e conferir o recebimento no Atendimento.

Este manual mostra onde clicar, como interpretar os estados da conexão e o que verificar quando uma conversa não chega. As capturas são reais, feitas na conta de demonstração da Nvoip; os estados exibidos podem ser diferentes na sua conta.

Antes de começar

  • Tenha acesso à conta anunciante correta na OLX e permissão para autorizar integrações.
  • Entre na conta Nvoip em que sua equipe fará os atendimentos.
  • Confirme que seu usuário pode acessar Integrações, Fluxo e Atendimento.
  • Defina a fila e os atendentes que receberão cada tipo de contato.
  • Verifique a disponibilidade do canal para sua conta. Se aparecer Em breve ou uma indicação de indisponibilidade, solicite orientação ao suporte antes de configurar a operação.

Disponibilidade: o recebimento depende das permissões concedidas, dos serviços habilitados na OLX e da liberação da integração para sua conta Nvoip. A presença do cartão no catálogo não garante que todos os tipos de evento estejam ativos.

Conversas e Leads: qual opção escolher?

Opção no Fluxo O que representa Como organizar o atendimento
Conversas Mensagens iniciadas no Chat OLX, no contexto de um anúncio Encaminhe para a fila que responde aos interessados
Leads Contatos recebidos pelo serviço de leads habilitado na OLX Encaminhe para a equipe que qualifica e acompanha oportunidades

O Chat OLX é reativo: a resposta acontece no contexto de uma conversa existente e permitida pela plataforma. Receber um lead não equivale a iniciar uma conversa no Chat OLX nem a obter uma autorização automática para enviar WhatsApp.

Este guia trata da OLX. Os conectores de ZAP Imóveis e Viva Real, embora pertençam ao mesmo grupo, têm configurações próprias. A integração de atendimento também não substitui um sistema de publicação ou sincronização de anúncios.

Passo 1 — Localizar a OLX no painel Nvoip

  1. Acesse o Painel Nvoip.
  2. Abra Integrações no menu.
  3. Digite OLX no campo de busca.
  4. Abra o cartão em Ver integração ou Gerenciar integração, conforme o estado da sua conta.
  5. Leia a aba Configuração para revisar as etapas e os dados utilizados.
Aba Configuração da OLX no painel Nvoip, com etapas de conexão e permissões utilizadas
Aba Configuração da OLX no painel Nvoip, com etapas de conexão e permissões utilizadas

Passo 2 — Autorizar a conta anunciante

  1. Abra a configuração de conexão pelo botão do cartão.
  2. Se ainda não houver conta vinculada, clique em Conectar OLX.
  3. Na página da OLX, entre com o usuário da conta anunciante que deseja conectar.
  4. Confira a conta selecionada e revise as permissões solicitadas.
  5. Autorize a integração e aguarde o retorno ao painel Nvoip.

A autenticação acontece na própria OLX. Você não precisa copiar tokens, chaves de API ou identificadores de conta para o painel Nvoip. Se o navegador já estiver conectado à OLX, confira o anunciante antes de confirmar, especialmente se você administra mais de uma conta.

Resultado esperado: a configuração passa a mostrar Conta anunciante da OLX conectada. Essa confirmação comprova a conexão; o próximo passo é conferir os serviços de recebimento.

Passo 3 — Conferir Chat, leads e permissões

Na janela Integração com OLX, confira os campos abaixo:

Campo O que verificar
Conta anunciante Se corresponde à conta que sua operação pretende atender
Recebimento do Chat Se está Ativo quando você pretende receber Conversas
Recebimento de leads Se está Ativo quando você pretende receber Leads
Permissões autorizadas Se a autorização inclui os recursos necessários à operação
Conexão OLX na Nvoip com conta conectada e estados de recebimento do Chat e de leads
Conexão OLX na Nvoip com conta conectada e estados de recebimento do Chat e de leads

Se aparecer uma mensagem de conexão parcial ou de serviços que ainda dependem de autorização, a conta pode estar conectada sem receber todos os eventos. Registre qual serviço está inativo e procure o suporte. Repetir a autorização sem verificar essa diferença pode não resolver o problema.

Passo 4 — Configurar a entrada da OLX no Fluxo

  1. Abra Configurações → Fluxo no painel Nvoip.
  2. Crie um fluxo de atendimento ou abra o fluxo que receberá esse canal.
  3. No editor, abra Adicionar Recurso → Canais e escolha OLX.
  4. Selecione o bloco OLX para abrir suas opções.
  5. Em Tipo de evento, escolha Conversas ou Leads.
  6. Confira a indicação de conta conectada. Se o editor pedir conexão, volte a Integrações e conclua a autorização.
  7. Conecte a saída do bloco à Fila responsável e confira os atendentes dessa fila.

Para organizar os dois eventos, configure entradas separadas. Um exemplo simples é OLX / Conversas → Fila de atendimento e OLX / Leads → Fila comercial. A fila pode ser a mesma quando a mesma equipe trata os dois assuntos; o tipo de evento ainda precisa corresponder ao contato recebido.

Na primeira configuração, prefira um caminho curto até a equipe. Depois de conferir a entrega, amplie o fluxo com os recursos compatíveis com o canal e com seu plano. Veja o manual completo de criação e publicação de Fluxos.

Passo 5 — Salvar e publicar o Fluxo

  1. Revise as conexões entre os blocos e as pendências indicadas pelo editor.
  2. Clique em Salvar Fluxo para guardar as alterações.
  3. Confira a opção de execução desejada antes de publicar.
  4. Clique em Publicar Fluxo e conclua a confirmação apresentada.
  5. Verifique se a versão publicada aparece e se a execução está Ativa para receber os eventos.
Controles reais do editor Nvoip para salvar, publicar e conferir a execução do Fluxo
Controles reais do editor Nvoip para salvar, publicar e conferir a execução do Fluxo

Salvar não publica. Uma alteração guardada no rascunho só passa a valer no atendimento após a publicação. Uma versão publicada com execução inativa também não atende os novos eventos como um fluxo ativo.

Passo 6 — Conferir o atendimento de ponta a ponta

Combine a conferência com sua equipe e use uma interação autorizada em um anúncio sob seu controle.

  1. Confira primeiro se o contato aparece na própria OLX.
  2. Para Conversas, use uma nova mensagem no Chat do anúncio. Para Leads, use um novo contato pelo recurso de leads habilitado.
  3. Abra Atendimento na Nvoip com um usuário da fila escolhida.
  4. Localize o contato e confira o canal, a mensagem e a equipe de destino.
  5. Em uma conversa de Chat que permita resposta, envie uma resposta manual combinada para o teste.
  6. Confira o recebimento no lado da OLX. Essa última etapa confirma o caminho de saída.

Teste Conversas e Leads separadamente. O sucesso de um deles não comprova o outro. O botão de teste do Fluxo ajuda na revisão da configuração, mas não substitui a chegada de um evento real da OLX.

Reconectar ou desconectar a OLX

Para renovar a autorização, volte a Integrações → OLX → Gerenciar integração e clique em Reconectar. Confirme a conta no provedor e revise novamente os estados de Chat e leads ao retornar.

Para encerrar o vínculo, use Desconectar na mesma janela e confira a confirmação do painel. Planeje a interrupção com a equipe: a operação não deve depender de uma conta desconectada para receber novos contatos. Não use desconexão como primeira tentativa para corrigir uma fila configurada incorretamente.

Solução de problemas

Situação O que fazer
OLX não aparece ou está indisponível Confirme a conta Nvoip, as permissões do usuário e a disponibilidade do canal com o suporte
Conectada, mas Chat ou leads inativo Confira o serviço afetado; a habilitação pode depender da OLX e das permissões autorizadas
Contato aparece na OLX, mas não na Nvoip Confira o tipo de evento, a conta vinculada, a versão publicada, a execução ativa e a fila de destino
Chegam Conversas, mas não Leads Revise o estado de leads e a entrada Leads; são caminhos distintos
Atendente não encontra o contato Confira se participa da fila de destino e se os filtros do Atendimento estão ocultando a conversa
Resposta não chega à OLX Verifique a mensagem de erro e se a conversa permite resposta; não presuma entrega apenas porque o texto foi digitado
Autorização abre a conta errada Confira a sessão da OLX no navegador e refaça o processo com o anunciante correto

Perguntas frequentes

Preciso criar um aplicativo na OLX ou informar token?

Não para o fluxo nativo apresentado aqui. A conexão parte do painel Nvoip e a autorização é concluída na OLX.

A integração importa todo o histórico antigo?

Não considere o histórico anterior automaticamente importado. Planeje a conferência com novos eventos após a conexão e a publicação do fluxo.

Posso iniciar conversas com qualquer usuário da OLX?

Não. O Chat funciona no contexto de conversas existentes e das permissões da plataforma. Leads e eventual contato por outro canal exigem tratamento próprio.

A OLX conectada ativa WhatsApp automaticamente?

Não. Conectar a OLX não configura nem autoriza, por si só, mensagens de WhatsApp. Confira os avisos de disponibilidade mostrados na integração.

Posso usar imagens, áudio ou outros anexos?

Use somente formatos explicitamente aceitos pelo canal e disponibilizados no Atendimento. Não presuma que os recursos de outros canais também estejam disponíveis na OLX.

Precisa de ajuda?

Abra uma solicitação pelo Suporte Técnico do painel e informe: canal OLX, tipo de evento, horário aproximado, estado do recebimento, nome do Fluxo e mensagem de erro. Envie capturas sem senhas, tokens ou dados pessoais desnecessários.

Continue por como usar a área de Integrações ou consulte o manual de integração do Mercado Livre.