Tutorial de Consulta e Enriquecimento de Leads com a Assertiva no Odoo

A integração com a Assertiva permite consultar e enriquecer automaticamente os dados de contatos e oportunidades do CRM a partir do CPF cadastrado no Odoo.

Após a consulta, as informações retornadas pela API, como e-mails, números de WhatsApp, telefones e endereços, são registradas no contato e disponibilizadas também na oportunidade correspondente.

1. Configurar a integração com a Assertiva

Antes de realizar qualquer consulta, é necessário configurar as credenciais da API da Assertiva na empresa correspondente.

No Odoo, acesse:

Configurações → Usuários e Empresas → Empresas

Em seguida:

1. Acesse Configurações.

2. Entre em Usuários e Empresas.

3. Clique em Empresas.

4. Selecione a empresa que utilizará a integração.

5. No cadastro da empresa, localize a aba Assertiva.

6. Preencha o campo Assertiva URL com a URL da API.

   • Exemplo: https://api.assertivasolucoes.com.br

7. Preencha o campo Assertiva Client ID.

8. Preencha o campo Assertiva Client Secret.

9. Salve as alterações.

Geração do Access Token

Não é necessário preencher ou gerar manualmente o Access Token da Assertiva.

O token é gerado automaticamente pelo Odoo utilizando o Client ID e o Client Secret configurados na empresa.

Antes de realizar uma consulta, o sistema verifica se já existe um token disponível e válido:

• Se existir um token válido, ele será reutilizado.

• Se não existir um token ou se o token anterior não estiver mais válido, o Odoo solicitará automaticamente um novo token à Assertiva.

• O novo token será armazenado para utilização nas próximas consultas.

• A Data/Hora de Geração do Token da Assertiva também será registrada pelo sistema.

Dessa forma, não é necessário solicitar um novo token manualmente a cada consulta.

Os campos Access Token da Assertiva e Data/Hora de Geração do Token da Assertiva são administrados automaticamente pela integração.

2. Verificar o CPF do contato

Antes de consultar uma oportunidade na Assertiva, verifique se o contato vinculado ao lead possui um CPF cadastrado corretamente.

No cadastro do contato:

1. Abra o contato vinculado à oportunidade.

2. Localize o campo Número de identificação.

3. Confirme se o tipo de identificação está definido como CPF.

4. Verifique se o número do CPF está preenchido corretamente.

5. Salve o contato caso tenha realizado alguma alteração.

O CPF utilizado pela integração é obtido a partir do cadastro do contato no Odoo.

Na oportunidade, esse documento será exibido automaticamente no campo CPF/CNPJ.

Importante sobre o campo CPF/CNPJ

O campo CPF/CNPJ apresentado na oportunidade não é preenchido manualmente.

Ele funciona como um espelho do documento cadastrado no contato vinculado ao lead, considerando o Número de identificação do tipo CPF, correspondente às informações de CPF/VAT mantidas no cadastro do contato.

Portanto, caso o CPF esteja vazio ou incorreto na oportunidade, a correção deverá ser realizada diretamente no cadastro do contato.

3. Consultar o lead na Assertiva

Com a integração configurada e o CPF corretamente cadastrado:

1. Acesse o módulo CRM.

2. Abra a oportunidade desejada.

3. Confirme se o contato correto está vinculado à oportunidade.

4. Verifique se o CPF aparece no campo CPF/CNPJ.

5. Clique no botão Consultar Lead na Assertiva.

O Odoo utilizará automaticamente o CPF do contato para realizar a consulta na API da Assertiva e iniciar o processo de enriquecimento.

Não é necessário informar novamente o CPF no momento da consulta.

4. Informações retornadas pela Assertiva

Quando a consulta for concluída com sucesso, os dados encontrados para o CPF consultado serão processados e vinculados aos registros correspondentes.

Canais de Contato (Assertiva)

Na aba Canais de Contato (Assertiva) poderão ser apresentados os dados retornados pela API, incluindo:

• E-mails Assertiva

• WhatsApp Assertiva

• Telefones Assertiva

Essas informações ficam associadas ao contato e à oportunidade consultada, permitindo que sejam utilizadas posteriormente pelos processos comerciais e de atendimento.

5. Endereços retornados

Os endereços encontrados durante o enriquecimento ficam disponíveis na aba:

Endereços (Assertiva)

Nessa seção, poderão ser exibidas as informações de endereço retornadas pela API para o CPF consultado.

Dessa forma, os dados enriquecidos ficam centralizados dentro da própria oportunidade do CRM.

6. Status Assertiva

O campo Status Assertiva permite acompanhar a situação do processo de enriquecimento.

Os status disponíveis são:

• Não cadastrado: o registro ainda não foi consultado ou processado pela integração.

• Pendente: a consulta foi solicitada e aguarda processamento.

• Cadastrado: a consulta foi concluída e os dados retornados foram processados.

• Erro: ocorreu algum problema durante a consulta ou durante o processamento das informações.

Após uma consulta concluída com sucesso, o Status Assertiva será atualizado para Cadastrado.

As informações retornadas poderão então ser consultadas nas abas Canais de Contato (Assertiva) e Endereços (Assertiva).

7. Consulta e enriquecimento em massa

Para consultas individuais, o enriquecimento pode ser iniciado diretamente pelo botão Consultar Lead na Assertiva.

Para operações em massa, quando vários leads ou contatos precisam ser consultados, o processamento utiliza o mecanismo de filas do Odoo, o Queue Job.

Nesse cenário, são criadas filas de processamento para que as consultas sejam executadas de maneira assíncrona.

Esse modelo permite:

• Processar grandes quantidades de registros sem bloquear a utilização do Odoo.

• Distribuir as consultas em diferentes jobs.

• Acompanhar individualmente a execução de cada processamento.

• Evitar que um grande volume de chamadas seja executado em uma única requisição.

• Tratar eventuais falhas de processamento de maneira mais controlada.

Assim, as consultas em massa são adicionadas à Queue e processadas gradualmente pelo Odoo.

Fluxo resumido da integração

• Configuração da empresa
  → Assertiva URL
  → Assertiva Client ID
  → Assertiva Client Secret

• Autenticação
  → Odoo verifica o token existente
  → Reutiliza o token válido ou gera um novo automaticamente

• Cadastro do contato
  → Número de identificação
  → Tipo = CPF

• Oportunidade no CRM
  → Contato vinculado
  → CPF refletido automaticamente no campo CPF/CNPJ

• Consulta
  → Clique em Consultar Lead na Assertiva

• Enriquecimento
  → E-mails
  → WhatsApp
  → Telefones
  → Endereços

• Resultado
  → Dados vinculados ao contato e ao lead
  → Status Assertiva = Cadastrado

Para processamento em massa
→ Seleção dos registros
→ Criação dos Jobs
→ Queue Job
→ Processamento assíncrono
→ Atualização dos registros