Histórico da Página
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?
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 O primeiro passo é adicionar 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.
Tipo de variável | Projeto | Chave | Valor | Descrição |
Projeto | Standard - TOTVS CRM-SPOTTER | raizoportunidade | Link padrão de oportunidades do TOTVS CRM | |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_leadsituationid | 1aa8633e-5ff3-4bc4-a7d5-1b63a879c4f2 | ID situação LEAD equivalente a ATIVO |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_phonetypeid_mobile | 67cd545a-cf05-441e-a0ec-635c44e60d41 | ID tipo de telefone equivalente a MÓVEL |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_stageid_qualificado | Leia a descrição | Preencher com o id da etapa de qualificado do Exact Spotter |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_phonetypeid_main | d870427c-bbad-4eb8-9af5-5183b47f648f | ID tipo de telefone equivalente a PRINCIPAL |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_addresstypeid | b604f287-36bf-4e6d-ae83-c75c46a2fbeb | ID Tipo de endereço equivalente a PRINCIPAL |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_default_user | Leia a descrição | Informar um e-mail existente no CRM para caso não seja encontrado o usuário responsável. OBS: este usuário deverá possuir um papel cadastrado, do contrário não será possível inserir o Lead/Cliente |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_pipeline | SQL - Sales Qualified Lead | Descrição da pipeline |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_oportunity_type | Nova venda | Descrição do tipo de oportunidade |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_oportunity_stage | Qualificados | Descrição da etapa (stage) |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_customerpersontype_pj | 40694c1a-44f9-4c3b-a5a8-aa63e0742c75 | ID tipo de pessoa equivalente a Jurídica |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_activity_type | e225924b-4895-4793-8d89-998b5fc735fb | ID tipo de atividade Formulário de investigação |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_token_exact | Leia a descrição | Token do Exact Spotter, localizado em: spotter/configuracoes/integracoes |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_leadoriginid | 81aed0c3-9fb9-4e4b-8a54-7c21c637c072 | ID origem equivalente a Spotter |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_preseller_default | Leia a descrição | Adicionar um e-mail padrão de um pré vendedor do Exact Spotter, para caso a integração não encontre o vendedor no TOTVS CRM. OBS: este pré vendedor deve ser cadastrado no TOTVS CRM |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_role_preseller | 417aeda6-f846-48bf-9f6c-23e1da9ce871 | ID do papel equivalente a Pré Vendedor |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_expecteddays | 7 | Prazo de conclusão da oportunidade, considere data atual + totvs_crm_expecteddays |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_identification_document_cnpj | 651b2c32-aeca-4373-9cb9-96b132ba5020 | ID do documento equivalente a CNPJ |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_identification_document_cpf | 95839570-6791-49f4-88fe-68efd115213d | ID do documento equivalente a CPF |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_lead_stage | 7a5600b1-7f7f-4460-853a-a8f2fb19b18e | ID da etapa do lead equivalente a Qualificado |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_content_type | application/json | - |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_emailtypeid | 7391c70e-aeb8-4c68-bd5c-7b5d30cf4d1d | ID tipo de e-mail |
Projeto | Standard - TOTVS CRM-SPOTTER | totvs_crm_customerpersontype | 8cea3c86-1984-4c77-acf5-3f622c1efe5b | ID tipo de pessoa equivalente a Física |
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:
Nome | Gatilho | Ação | Filtros | URL |
Exact Spotter - Atividade Cancelada | Atividade cancelada | Chamar um endpoint HTTP remoto | - | URL do serviço do iPaaS Activity TOTVS CRM to Exact Spotter |
Exact Spotter - Atividade Concluída | Atividade concluída | Chamar um endpoint HTTP remoto | - | URL do serviço do iPaaS Activity TOTVS CRM to Exact Spotter |
Exact Spotter - Oportunidade Atualizada | Oportunidade atualizada | Chamar um endpoint HTTP remoto | Tipo de oportunidade igual a Nova venda | URL do serviço do iPaaS Opportunity TOTVS CRM to Lead Exact Spotter |
Exact Spotter - Oportunidade Descartada | Oportunidade descartada | Chamar um endpoint HTTP remoto | Tipo de oportunidade igual a Nova venda | URL do serviço do iPaaS Opportunity TOTVS CRM to Lead Exact Spotter |
Exact Spotter - Oportunidade Ganha | Oportunidade ganha | Chamar um endpoint HTTP remoto | Tipo de oportunidade igual a Nova venda | URL do serviço do iPaaS Opportunity TOTVS CRM to Lead Exact Spotter |
Exemplo do fluxo
FAQ