Páginas filhas
  • 7 - Exact Spotter - TOTVS CRM

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

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"
}

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.


Pré-requisitos iPaaS:

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ávelProjetoChaveValorDescrição
ProjetoStandard - TOTVS CRM-SPOTTERraizoportunidade

https://totvscrm.app/opportunity/opportunities/

Link padrão de oportunidades do TOTVS CRM
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_leadsituationid

1aa8633e-5ff3-4bc4-a7d5-1b63a879c4f2

ID situação LEAD equivalente a ATIVO
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_phonetypeid_mobile

67cd545a-cf05-441e-a0ec-635c44e60d41

ID tipo de telefone equivalente a MÓVEL
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_stageid_qualificado

Leia a descrição

Preencher com o id da etapa de qualificado do Exact Spotter
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_phonetypeid_main

d870427c-bbad-4eb8-9af5-5183b47f648f

ID tipo de telefone equivalente a PRINCIPAL

ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_addresstypeid

b604f287-36bf-4e6d-ae83-c75c46a2fbeb

ID Tipo de endereço equivalente a PRINCIPAL

ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_default_user

Leia a descrição

Informar um e-mail existe 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

ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_pipeline

SQL - Sales Qualified Lead

Descrição da pipeline
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_oportunity_type

Nova venda

Descrição do tipo de oportunidade
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_oportunity_stage

Qualificados

Descrição da etapa (stage)
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_customerpersontype_pj

40694c1a-44f9-4c3b-a5a8-aa63e0742c75

ID tipo de pessoa equivalente a Jurídica
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_activity_type

e225924b-4895-4793-8d89-998b5fc735fb

ID tipo de atividade Formulário de investigação
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_token_exact

Leia a descrição

Token do Exact Spotter, localizado em: spotter/configuracoes/integracoes
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_leadoriginid

81aed0c3-9fb9-4e4b-8a54-7c21c637c072

ID origem equivalente a Spotter
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_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

ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_role_preseller

417aeda6-f846-48bf-9f6c-23e1da9ce871

ID do papel equivalente a Pré Vendedor
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_expecteddays

7

Prazo de conclusão da oportunidade, considere data atual + totvs_crm_expecteddays
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_identification_document_cnpj

651b2c32-aeca-4373-9cb9-96b132ba5020

ID do documento equivalente a CNPJ
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_identification_document_cpf

95839570-6791-49f4-88fe-68efd115213d

ID do documento equivalente a CPF
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_lead_stage

7a5600b1-7f7f-4460-853a-a8f2fb19b18e

ID da etapa do lead equivalente a Qualificado
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_content_type

application/json

-
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_emailtypeid

7391c70e-aeb8-4c68-bd5c-7b5d30cf4d1d

ID tipo de e-mail
ProjetoStandard - TOTVS CRM-SPOTTERtotvs_crm_customerpersontype

8cea3c86-1984-4c77-acf5-3f622c1efe5b

ID tipo de pessoa equivalente a Física

Pré-requisitos TOTVS CRM:

Crie os seguintes Workflows:

NomeGatilhoAçãoFiltrosURL
Exact Spotter - Atividade CanceladaAtividade canceladaChamar um endpoint HTTP remoto-URL do serviço do iPaaS Activity TOTVS CRM to Exact Spotter
Exact Spotter - Atividade ConcluídaAtividade concluídaChamar um endpoint HTTP remoto-URL do serviço do iPaaS Activity TOTVS CRM to Exact Spotter
Exact Spotter - Oportunidade AtualizadaOportunidade atualizadaChamar um endpoint HTTP remotoTipo de oportunidade igual a Nova vendaURL do serviço do iPaaS Opportunity TOTVS CRM to Lead Exact Spotter
Exact Spotter - Oportunidade DescartadaOportunidade descartadaChamar um endpoint HTTP remotoTipo de oportunidade igual a Nova vendaURL do serviço do iPaaS Opportunity TOTVS CRM to Lead Exact Spotter
Exact Spotter - Oportunidade GanhaOportunidade ganhaChamar um endpoint HTTP remotoTipo de oportunidade igual a Nova vendaURL do serviço do iPaaS Opportunity TOTVS CRM to Lead Exact Spotter

Exemplo do fluxo

FAQ