Pular para o conteúdo principal

Odoo Sync

O Odoo Sync conecta seu espaço de trabalho do MonoChat ao seu banco de dados do Odoo, no Odoo Online, no Odoo.sh ou no seu próprio servidor. O app:

  • envia o nome, o telefone, o e-mail e os campos de perfil mapeados dos seus clientes para o contato ou lead de CRM deles no Odoo, e cria um quando não existe,
  • lê a cada 10 minutos os contatos e leads alterados no Odoo e atualiza os clientes correspondentes no MonoChat,
  • publica cada conversa encerrada como nota no chatter do contato ou do lead,
  • mostra as faturas e os pedidos de venda do cliente ao lado da conversa e envia um link de pagamento para uma fatura em aberto,
  • registra o pagamento na fatura do Odoo quando o cliente paga o link.

Antes de começar​

Você precisa de:

  1. Odoo 17 ou posterior com acesso à API. O Odoo dá acesso à API no plano Custom; um Odoo hospedado por você também tem.
  2. Uma chave de API. No Odoo, abra Preferences › Account Security do usuário em nome do qual o app vai agir e clique em New API Key. O Odoo mostra a chave uma única vez: copie-a. O Odoo recomenda um usuário dedicado a integrações, só com o acesso necessário.
  3. Os apps do Odoo que você usa. Os contatos são sempre sincronizados. Leads precisam do app CRM, pedidos do app Vendas e faturas do app Faturamento ou Contabilidade.
  4. Um sistema de pagamento no MonoChat para enviar links de pagamento. O app usa seu sistema de pagamento padrão.

Conectar o Odoo​

  1. Instale o app pela MonoStore.
  2. Abra Configurações › Odoo.
  3. Informe o Odoo address (por exemplo https://yourcompany.odoo.com) e o nome do Database.
  4. No Odoo 18 e anteriores, informe em Login (Odoo 18 and earlier) o login do usuário dono da chave de API. O Odoo 19 e posteriores não precisam dele.
  5. Cole a API key, clique em Save e depois em Test connection.

O app usa a API JSON-2 do Odoo a partir do Odoo 19 e JSON-RPC nas versões anteriores; a tela mostra qual foi usada. A chave de API não é mostrada de novo; deixe o campo vazio para manter a salva. Só o proprietário ou um gerente podem alterar estas configurações. Se mudar o endereço ou o banco de dados, digite a chave de API de novo.

O que é sincronizado​

ConfiguraçãoO que faz
Sync customers withOnde um cliente do MonoChat é criado quando o Odoo não tem registro dele: Contacts ou CRM leads.
Add new Odoo records with a phone number as MonoChat customersUm contato ou lead criado no Odoo depois da conexão, com telefone, vira um cliente do MonoChat para quem sua equipe pode escrever.
Post each closed conversation to the record’s chatterQuando uma conversa é encerrada, as mensagens desde a última nota (no máximo as últimas 100) são publicadas como nota no chatter. Notas internas ficam de fora.
JournalO diário de banco ou de caixa em que o pagamento de um link pago é registrado. Sem escolha, o Odoo decide.
Field mappingAté cinco campos de perfil, cada um com o nome técnico de um campo do Odoo (o Odoo o mostra no modo desenvolvedor) e uma direção: Both ways, To Odoo only ou From Odoo only. Nome, telefone e e-mail são sempre sincronizados.
  • Do MonoChat para o Odoo: quando o perfil de um cliente muda, o app encontra o contato ou lead dele pelo e-mail ou telefone, ou cria um, e envia só os valores que mudaram.
  • Do Odoo para o MonoChat: a cada 10 minutos o app lê os contatos e leads alterados no Odoo e atualiza os clientes vinculados, ou o cliente com o mesmo telefone ou e-mail. Um valor que veio do Odoo não é enviado de volta.
  • Quando o cliente de um lead aparece depois como contato no Odoo, o cliente é vinculado ao contato.
  • Configurações › Odoo mostra quando a última leitura rodou e o erro dela, se falhou.
  • Um registro que não pode ser aplicado no MonoChat não interrompe a leitura: a tela mostra quantos foram ignorados, com o último e o motivo.

Ao lado da conversa​

O cartão Odoo ao lado da conversa lista as últimas faturas do cliente, com o valor em aberto e se estão pagas, e os últimos pedidos de venda. Em uma fatura em aberto, Send payment link envia ao cliente uma mensagem com um link de pagamento do valor em aberto.

Use nos seus fluxos​

Adicione um nó Função a um fluxo em Configurações › Automação › Fluxos e escolha um dos nós do app. Veja Fluxos.

NóO que fazSaídas
Odoo · Send orders or invoicesEnvia ao cliente as faturas em aberto ou os últimos pedidos de venda (número, valor e data) sob o título que você escrever.Sent, None, Not in Odoo
Odoo · Send invoice payment linkCria um link de pagamento para a fatura em aberto mais antiga do cliente, pelo valor em aberto, e o envia com sua mensagem. Escreva {invoice}, {amount} e {link} onde devem aparecer.Sent, No invoice, Not in Odoo, No payment system

Not in Odoo significa que o app não encontrou um contato do Odoo para o cliente. Quando o Odoo recusa a solicitação, o nó segue pelo ramo de falha.

Use com seu agente de IA​

Adicione as ferramentas do app ao seu agente de IA:

  • Odoo · Read the customer's orders and invoices dá ao agente os últimos pedidos de venda e faturas do cliente, com valores, datas e o que está em aberto.
  • Odoo · Get an invoice payment link dá ao agente um link de pagamento para a fatura que o cliente indicar, ou a mais antiga em aberto, para compartilhar na resposta.

Quando o cliente paga​

O link de pagamento fica na moeda da fatura. Quando o cliente paga, o app registra o pagamento na fatura do Odoo, no diário escolhido, com MonoChat e o número do pagamento como memorando. Uma fatura já paga no Odoo fica como está.

Bom saber​

  • O Odoo ainda não consegue avisar o MonoChat, então as mudanças do Odoo chegam ao MonoChat em até 10 minutos.
  • Registros alterados no Odoo antes da conexão não são lidos. Um cliente é vinculado ao Odoo quando o perfil dele muda, uma conversa é encerrada ou o app lê uma mudança no Odoo.
  • O app age no Odoo como o usuário da chave de API: vê e altera o que esse usuário pode.