Integração de Leads, Contatos, Oportunidades e Atividades do Exact Spotter para o TOTVS CRM

Contexto

Sistemas Envolvidos

• Exact Spotter
• iPaaS
• TOTVS CRM

O que esta integração faz?

Escopo

Quais campos podem ser integrados entre Exact Spotter e o TOTVS CRM?

A tabela abaixo representa de/para dos dados vindo no JSON de lead/oportunidade do Exact Spotter:

Pré-requisitos Cliente

Pré-requisitos Exact Spotter

Para que os leads, contatos, oportunidades e atividades sejam integrados corretamente, é necessário cadastrar alguns eventos no Exact Spotter que chamarão os Webhooks, enviado a informação da forma correta ao IpaaS e posteriormente para o TOTVS CRM.

Utilize a seguinte documentação para inserir os eventos: https://exactspotter.docs.apiary.io/#/reference/0/webhooks-insercao

Dica: você pode utilizar o programa Postman para inserir os eventos.

Os eventos e os corpos da requisições são:

• • event.schedule

{
    "event": "event.schedule",
    "url": "URL do Webhook do serviço Lead Exact Spotter to TOTVS CRM"
}

• • event.reschedule

{
    "event": "event.reschedule",
    "url": "URL do Webhook do serviço Lead Exact Spotter to TOTVS CRM"
}

Para o serviço iPaaS Activity Exact Spotter to TOTVS CRM:

• • event.activitycreated

{
    "event": "event.activitycreated",
    "url": "URL do Webhook do serviço Activity Exact Spotter to TOTVS CRM"
} 

• • event.activitydeleted

{
    "event": "event.activitydeleted",
    "url": "URL do Webhook do serviço Activity Exact Spotter to TOTVS CRM"
}

• • event.activitydone

{
    "event": "event.activitydone",
    "url": "URL do Webhook do serviço Activity Exact Spotter to TOTVS CRM"
}

• • event.activityedited

{
    "event": "event.activityedited",
    "url": "URL do Webhook do serviço Activity Exact Spotter to TOTVS CRM"
}

Pré-requisitos iPaaS:

Adicione uma conta no aplicativo TOTVS CRM:

• Acesse o aplicativo TOTVS CRM
• Vá na aba Contas e clique em "Cadastrar Conta"
• Você pode configurar de duas formas, via body ou via bearer token, conforme as imagens abaixo:

Adicione uma conta no aplicativo Exact Sales:

• Acesse o aplicativo Exact Sales
• Vá na aba Contas e clique em "Cadastrar Conta" e configure conforme a imagem abaixo:

O próximo passo é clonar do projeto padrão para a sua respectiva empresa no iPaaS.

Para isso, realize os seguintes procedimentos:

• Abra o seu navegador e acesse o site https://ipaas.totvs.app/
• No menu do site, procure pela opção "Integrações" e clique nela
• Em seguida, procure pelo submenu "Variáveis" e selecione essa opção
• Procure o projeto clonado Standard - TOTVS CRM-SPOTTER
• Agora, você deve preencher os campos "Chave" e "Valor" para cada variável

Segue os valores a serem preenchidos:

Observação: É importante salientar que os valores de ID fornecidos acima são exemplos baseados na configuração padrão do TOTVS CRM. Durante a implementação da integração, é fundamental revisar e ajustar os valores de ID de acordo com o tenant do cliente. Isso garante que a integração seja realizada corretamente.

Pré-requisitos TOTVS CRM:

Cadastre um e-mail existente no TOTVS CRM e Exact Spotter para caso não seja encontrado o usuário responsável ao cadastrar um lead/oportunidade. (variável totvs_crm_default_user)

Cadastre um e-mail existente no TOTVS CRM e Exact Spotter para caso não seja encontrado o pré vendedor ao cadastrar um lead/oportunidade. (variável totvs_crm_preseller_default)

Crie os seguintes Workflows:

Exemplo do fluxo

FAQ