Versões comparadas

Chave

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

Integração de Leads e Oportunidades do Exact Spotter para TOTVS CRM em unidades TOTVS Corp   

Contexto

A integração entre o Exact Spotter e o TOTVS CRM por meio do TOTVS IPAAS foi desenvolvida para otimizar o fluxo de informações entre essas duas plataformas. Com a integração entre as ferramentas você pode automatizar o processo de envio de lead/oportunidades geradas no Exact Spotter para o TOTVS CRM. Isso significa que os dados dos potenciais clientes são enviados automaticamente, sem a necessidade de intervenção manual, o que reduz significativamente o tempo gasto nessa tarefa e elimina erros que poderiam ocorrer durante o processo.


Sistemas Envolvidos
  • EXACT SPOTTER
  • TOTVS IPAAS
  • TOTVS CRM


Unidades que usam este modelo de integração

  • TOTVS Ibirapuera
  • TOTVS SMB SP
  • TOTVS SMB RJ
  • TOTVS SMB BH
  • TOTVS SMB RECIFE


O que esta integração faz?

O fluxo de integração tem por objetivo principal integrar leads/clientes, contatos, oportunidades e atividades do Exact Spotter com o TOTVS CRM para que o profissional de vendas continue o processo de evolução no TOTVS CRM de uma oportunidade inicialmente gerada com o uso do Exact Spotter por um assistente de vendas ou pré-vendedor.


Diagrama da integração de Leads/Oportunidades com origem no Exact Spotter para o TOTVS CRM

Image Modified


Diagrama da integração TOTVS CRM → Exact Spotter

Image Modified


Quando um lead/oportunidade é enviado ao TOTVS CRM?

Quando o lead/oportunidade entra na etapa "Lead Qualificado" do funil, é acionado um gatilho para que o registro seja enviado ao IPAAS para realizar a integração com o TOTVS CRM:


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

Abaixo estão as entidades que vem do Exact Spotter e são integradas ao TOTVS CRM.

Em cada uma delas, temos também o JSON de exemplo para aprimorar o entendimento do leitor.

Sempre que um lead é qualificado no Exact Spotter um evento é disparado para o IPAAS que integra as informações de Lead/Cliente, Contato, Oportunidade, Equipe da oportunidade e Atividade com o TOTVS CRM.

JSON de exemplo: json_lead_e_afins.txt

Lead/Cliente (Lead/Customer):

Inserção do lead/cliente no TOTVS CRM.

Exact SpotterFormatoTOTVS CRM
valor padrão truebooleanactive

Lead.Address.Address_Maps

Se nulo Então Endereço Padrão

stringaddresses.address
variável totvs_crm_addresstypeiduuidaddresses.addressType.id
Lead.Address.AddAddressInformationstringaddresses.complement
Lead.Address.Citystringaddresses.cityName
Lead.Address.Countrystringaddresses.countryName
Lead.Address.Statestringaddresses.stateName

Lead.Address.Address_Maps

Se nulo Então Endereço Padrão

stringaddresses.description
SPOTTER #' Lead.SsnEinstringaddresses.externalId
Lead.Address.ZipCodestringaddresses.postalCode
Lead.Idstringcode
valor padrão falsebooleanconverted

Se mandou um CNPJ Então variável totvs_crm_customerpersontype_pj

Se mandou um CPF Então variável totvs_crm_customerpersontype

uuidcustomerPersonType.id
SPOTTER # Lead.SsnEinstringexternalId

Lead.SsnEin

stringleadIdentificationDocuments.documentNumber

SPOTTER # Lead.SsnEin

stringleadIdentificationDocuments.externalId

Se mandou um CNPJ Então CNPJ

Se mandou um CPF Então CPF

stringleadIdentificationDocuments.identificationDocumentAcronym

Se mandou um CNPJ Então CNPJ

Se mandou um CPF Então CPF

uuidleadIdentificationDocuments.identificationDocumentId
valor padrão truebooleanleadOrigin.defaultValue
variável totvs_crm_leadoriginiduuidleadOrigin.id
variável totvs_crm_lead_stageuuidleadStage.id
Lead.Industry.iduuidlocationBusinessLine.id
Lead.Companystringname
SPOTTER # Lead.SsnEinstringphones.externalId
Lead.Phonestringphones.number
variável totvs_crm_phonetypeid_mainuuidphones.phoneTypeId
valor padrão truebooleanphones.standard

Lead.SalesRep.Email (busca por username no TOTVS CRM)

Se nulo Então variável totvs_crm_default_user

uuidprofessionalId

Lead.SalesRep.Email (busca por username no TOTVS CRM)

Se nulo/não encontrado Então variável totvs_crm_default_user

stringprofessionalName
Lead.CompanystringtradingName
Lead.Sitestringwebsite


Contato (Contact):

Inserção do contato do lead/cliente  no TOTVS CRM.

Exact SpotterFormatoTOTVS CRM
valor padrão truebooleanactive
Lead.Contact.Emailstringemails.email
variável totvs_crm_emailtypeiduuidemails.emailTypeId
SPOTTER # Lead.Contact.Idstringemails.externalId
valor padrão truebooleanemails.standard
SPOTTER # Lead.Contact.IdstringexternalId

Se Lead.Contact.TypeMessenger = Facebook Então facebook

Se Lead.Contact.TypeMessenger = Instagram Então instagram

Se Lead.Contact.TypeMessenger = LinkedIn Então linkedin

Se Lead.Contact.TypeMessenger = Twitter Então twitter


string


facebook | instagram | linkedin | twitter

SPOTTER # Lead.SsnEinuuidleadId
Lead.Contact.Namestringname
SPOTTER # Lead.Contact.Idstringphones.externalId
Lead.Contact.Phonestringphones.number
variável totvs_crm_phonetypeid_mainuuidphones.phoneTypeId
valor padrão truebooleanphones.standard
Lead.Contact.Positionstringrole


Oportunidade (Opportunity):

Inserção da oportunidade para o lead/cliente no TOTVS CRM.

Exact SpotterFormatoTOTVS CRM

Se for um Lead Então valor padrão LEAD

Se for um Lead Então valor padrão CUSTOMER

stringaccountType
SPOTTER #' Lead.SsnEinuuidaddress.id
SPOTTER # Lead.Contact.Iduuidcontacts.id
valor padrão Oportunidade criada para o Lead + Lead.Companystringdescription
data corrente + variável totvs_crm_expecteddaysstring(uuuu-MM-dd'T'HH:mm:ss.SSS'Z')expectedAt
SPOTTER # Lead.SsnEin # Lead.IdstringexternalId
SPOTTER # Lead.SsnEinuuidleadId | customerId
valor padrão Lead no Spotter: + Lead.PublicLinkstringnote
variável totvs_crm_oportunity_typeuuidopportunityTypeId
variável totvs_crm_pipelineuuidpipelineId
variável totvs_crm_oportunity_stageuuidstageId
data correntestring(uuuu-MM-dd'T'HH:mm:ss.SSS'Z')startedAt
valor padrão PROGRESSstringstatus
valor padrão 0numbertotalRecurrentValue
valor padrão 0numbertotalSingleValue
valor padrão 0numbertotalValue

Lead.SalesRep.Email (busca por username no TOTVS CRM)

Se nulo/não encontrado Então variável totvs_crm_default_user

uuiduserId


Equipe da oportunidade (Team Members):

Inserção do pré vendedor na oportunidade no TOTVS CRM.

Exact SpotterFormatoTOTVS CRM
valor padrão truebooleanactive
valor padrão READ, UPDATE, TRANSFER e SHAREstringallowedActions
SPOTTER # Lead.SsnEin # Lead.IdstringexternalId
valor padrão 1numberpercentageOfParticipation
valor padrão truebooleanresponsible
variável totvs_crm_role_preselleruuidroleId

Lead.SDR.Email

Se nulo/não encontrado Então variável totvs_crm_preseller_default

uuiduserId


Atividade (Activity):

Esta atividade é criada/atualizada assim que o lead/cliente é agendado/reagendado no Exact Spotter, a mesma está vinculada com a oportunidade do funil.

Exact SpotterFormatoTOTVS CRM
variável totvs_crm_activity_typeuuidactivityTypeId
valor padrão falsebooleanallDay
Appointment.Reference + Appointment.MeetingTypestringdescription
Appointment.DateTimeEndDatestring(uuuu-MM-dd'T'HH:mm:ss.SSS'Z')endDate
SPOTTER # Lead.SsnEin # Lead.IdstringexternalId
SPOTTER # Lead.SsnEinuuidleadId | customerId
valor padrão Link Feedback: + Appointment.LinkFeedbackstringnote
Appointment.Referencestringorigin.description
SPOTTER # Lead.SsnEin # Lead.Iduuidorigin.id
valor padrão OPPORTUNITYstringorigin.type
valor padrão MEDIUMstringpriority
Appointment.DateTimeStartDatestring(uuuu-MM-dd'T'HH:mm:ss.SSS'Z')startDate
valor padrão OPENstringstatus

Lead.SalesRep.Email (busca por username no TOTVS CRM)

Se nulo/não encontrado Então variável totvs_crm_default_user

uuiduserId

Pré-requisitos Cliente

É necessário contratar o pacote Essential ou superior do Exact Spotter.


Pré-requisitos IPAAS:

Clone o diagrama de uma unidade de negócio existente no projeto Standard-CRM-Spotter-PRODUCAO, no IPAAS. Como sugestão, clonar o diagrama TSE001 - TOTVS SAO PAULO

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
  • Acessar Projetos e Pacotes e entrar no projeto Standard-CRM-Spotter-PRODUCAO,
  • Clicar no botão dos três pontinhos no diagrama TSE001 - TOTVS SAO PAULO e após isto, DUPLICAR.

  • No canto superior do diagrama clonado, altere o nome conforme a unidade a ser adicionada

  • Configurar o diagrama conforme as imagens abaixo:

  • Depois disso clique em publicar diagrama;


Pré-requisitos TOTVS CRM:

Cadastre um usuário no TOTVS CRM para a integração, este usuário deverá ser admin e ser marcado no banco como tal. Solicitar ao time de devOps da TOTVS CRM.

O fluxo de integração utiliza variáveis para que seja possível integrar mais unidades de negócio sem a necessidade de criar um projeto completo de integração.

As variáveis adotadas para cada unidade de negócio ficam armazenadas em um objeto personalizado do CRM, com o cadastro disponível em:

Image Modified > Telas customizadas > Variáveis CRM x Spotter

Devem ser preenchidos os campos do formulário para cada unidade de negócio, abaixo:

ColunaValor de exemploObservação
DIAGRAMA IPAASTSE000 - TOTVS TESTENome do diagrama da unidade clonada no iPaaS
CRM COMPANYIDab58f2c6-3e15-46a1-88a2-bce7f3d3a2dxIdentificador no CRM da unidade de negócio, cadastrado como empresa
CRM ROLE IDddf7aab8-d605-475e-99c4-d7af93259978Identificador no CRM do papel do usuário
CRM BEARER TOKENBearer TOKEN

Token do usuário de integração do TOTVS CRM criado exclusivamente para a integração da unidade em questão. 

OBS: esse usuário é importante para diferenciar as demais unidades caso o time interno precise identificar problemas.

OBS2: esse valor é pego da seguinte forma:

CRM ID AGRUPADOR DE VENDA0034Código do agrupador de venda padrão para a oportunidade, para a unidade de negócio
CRM DESCRIÇÃO AGRUPADOR DE VENDATRADICIONALDescrição do agrupador de venda padrão para a oportunidade, para a unidade de negócio
SPOTTER TOKEN EXACT5c895e3f-e498-4a6d-b191-819660cbe523

Token do usuário de integração do Exact Spotter, localizado em: configuracoes/integracoes

SPOTTER DEFAULT PRE SELLER[email protected]

E-mail do usuário padrão cadastrado como pré-vendedor, utilizado caso não encontre o email do pré-vendedor da oportunidade no Exact Spotter

SPOTTER DEFAULT USER[email protected]

E-mail do usuário padrão cadastrado como vendedor, utilizado caso não encontre o email do pré-vendedor da oportunidade no Exact Spotter


Após configurado as variáveis específicas da unidade, é necessário criar os Workflows que dispara a volta da atualização da oportunidade para o Exact Spotter

NomeGatilhoAçãoFiltros

URL

URL do serviço do

IPAAS Opportunity TOTVS CRM to Lead Exact Spotter

Image Removed

IPAAS  TSE000 - TOTVS TESTE

Image Added

Exact - NOME_UNIDADE
Exact Spotter
- Oportunidade PerdidaOportunidade perdidaChamar um endpoint HTTP remoto

Empresa = UNIDADE DA CORP 

AND

ID Externo contém

Tipo de Oportunidade igual SPOTTER

Exact
Spotter - Oportunidade
- NOME_UNIDADE - Oportunidade GanhaOportunidade ganhaChamar um endpoint HTTP remoto

Empresa = UNIDADE DA CORP 

AND

ID Externo contém

Tipo de Oportunidade igual SPOTTER

Exact
Spotter - Oportunidade
- NOME_UNIDADE - Oportunidade DescartadaOportunidade descartadaChamar um endpoint HTTP remoto

Empresa = UNIDADE DA CORP 

AND

ID Externo contém

Tipo de Oportunidade igual SPOTTER

Pré-requisitos Exact Spotter

Para que o lead/cliente seja integrado corretamente com o TOTVS CRM, é necessário cadastrar o evento leadqualified no Exact Spotter que chamará o diagrama TSE000 - TOTVS TESTE que criamos acima como exemplo.

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 o evento.

Segue documentação para auxilio: https://exactspotter.docs.apiary.io/#/reference/0/webhooks-insercao

O evento que vamos adicionar é:

    • event.leadqualified

Com o seguinte body:

Bloco de código
{
    "event": "event.leadqualified",
    "url": "URL do Webhook do diagrama TSE000 - TOTVS TESTE"
}

Após isso, todo lead qualificado no Exact Spotter será integrado com o TOTVS CRM.