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

Diagrama da integração TOTVS CRM → Exact Spotter

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:

> 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 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 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 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 Spotter

NomeGatilhoAçãoFiltrosURL
Exact Spotter - Oportunidade PerdidaOportunidade perdidaChamar um endpoint HTTP remoto

Empresa = UNIDADE DA CORP 

AND

ID Externo contém SPOTTER

URL do serviço do IPAAS Opportunity TOTVS CRM to Lead Exact Spotter

Exact Spotter - Oportunidade GanhaOportunidade ganhaChamar um endpoint HTTP remoto

Empresa = UNIDADE DA CORP 

AND

ID Externo contém SPOTTER

URL do serviço do IPAAS Opportunity TOTVS CRM to Lead Exact Spotter

Exact Spotter - Oportunidade DescartadaOportunidade descartadaChamar um endpoint HTTP remoto

Empresa = UNIDADE DA CORP 

AND

ID Externo contém SPOTTER

URL do serviço do IPAAS Opportunity TOTVS CRM to Lead Exact 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:

{
    "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.

Exemplo do fluxo

FAQ

É possível customizar a integração para atender às necessidades específicas de um negócio? 

Sim, é possível contemplar campos customizados de interesse do cliente, porém, será necessária uma contratação adicional do serviço. A inclusão desses campos personalizados exigirá uma modificação no diagrama/pipeline do IPAAS fornecido ao cliente específico.

É importante destacar que o modelo atual do IPAAS utiliza apenas os campos padrão disponibilizados pela API do TOTVS CRM. Portanto, qualquer adição de campos personalizados requer uma alteração no IPAAS, que será realizada através do atendimento da área de serviços.

Dessa forma, o cliente terá a oportunidade de personalizar a integração de acordo com suas necessidades específicas, incluindo campos customizados de interesse. O processo de alteração será coordenado pela equipe de serviços, garantindo a correta adaptação do TOTVS CRM e o bom funcionamento da integração com o Exact Spotter