Integração com Followize (Dealerspace)

A Duotalk permite integração direta com o CRM Followize, agora dealerspace, em diferentes tipos de processos.

Essa documentação descreve como a Duotalk trata essa integração de forma padronizada para garantir o correto funcionamento e evitar erros de validação.

Importante: Em cenários de Processo 2, além do envio do campo attendantId (usuário com perfil de “atendente”), é necessário o envio do campo salesmanId no payload — representando o vendedor responsável pelo lead na Followize.

🔧 Lógica de Identificação de vendedores/atendentes

Para poder adaptar nosso produto ao processo do CRM parceiro, adotamos uma convenção simples no cadastro do usuário da Duotalk: quando o campo customizado de ID Followize iniciar com o prefixo salesmanId, o sistema irá reconhecer esse usuário como vendedor e adaptar o envio da integração automaticamente.

1. Prefixo “salesmanId:” na criação de usuários

   • Se o campo customizado do usuário começar com salesmanId: (case-insensitive, espaços tolerados), o número que vier depois será extraído e enviado como salesmanId no payload da integração.

   

2. Fallback para attendantId

   • Se não houver o prefixo, o valor inteiro será enviado como attendantId.

   • Em caso de valor malformado ou ausente, o sistema faz fallback para attendantId vazio e registra log de erro.

🧾 Payload de Exemplo — Usuário Vendedor

{
  "clientKey": "SEU_CLIENT_KEY",
  "conversionGoal": "Teste processo dois",
  "name": "Nome do Lead",
  "email": "[email protected]",
  "categoryTitle": null,
  "productTitle": null,
  "message": "(13/06/2025, 16:03:54) Nome do Lead: Oi\\n(13/06/2025...)",
  "tipoIntegracao": "Transferência",
  "teamKey": null,
  "phone": "5511999999999",
  "hubUtmz": "utmcsr=Duotalk - WhatsApp 360|utmcct=Duotalk - Não informado|utmcmd=Duotalk - Não informado|utmccn=Duotalk - Não informado",
  "salesmanId": "ID_DO_VENDEDOR",
  "integrationTypeId": 45
}

🧾 Payload de Exemplo — Usuário Atendente

{
  "clientKey": "SEU_CLIENT_KEY",
  "conversionGoal": "Teste processo dois",
  "name": "Nome do Lead",
  "email": "[email protected]",
  "categoryTitle": null,
  "productTitle": null,
  "message": "(13/06/2025, 16:03:54) Nome do Atendente: Oi\\n(13/06/2025, 16:03:54)",
  "tipoIntegracao": "Transferência",
  "teamKey": null,
  "phone": "5511999999999",
  "hubUtmz": "utmcsr=Duotalk - WhatsApp 360|utmcct=Duotalk - Não informado|utmcmd=Duotalk - Não informado|utmccn=Duotalk - Não informado",
  "attendantId": "ID_DO_ATENDENTE",
  "integrationTypeId": 45
}

• clientKey: Campo obrigatório, identifica o cliente na Followize

• attendantId: será enviado quando não houver o prefixo “salesmanId:”

• salesmanId: será enviado apenas em casos onde o prefixo “salesmanId:” for identificado

• message: campo com histórico da conversa que será visualizado no CRM

• tipoIntegracao: aceita valores como "abertura", "transferência", "fechamento"

• integrationTypeId: utilizado para controlar o tipo de integração, definido pela Duotalk

📌 Considerações Importantes

• O campo salesmanId deve estar cadastrado e ativo na conta (clientKey) da Followize

• Caso o salesmanId informado não seja reconhecido, o sistema da Followize pode:

  • Ignorar o campo (comportamento configurável)

  • Retornar erro de validação (ex: 4003 - Falha ao cadastrar o contato)

• O campo attendantId, se presente, é utilizado para manter compatibilidade com Processos do Tipo 1.

⚠ OBRIGATÓRIO para Clientes Duotalk com Processo 2 na Followize

• Na Duotalk: Não poderá ser informado o “teamKey” na criação da integração, pois a integração corre risco de não acontecer

• Na Followize: O cliente deve configurar a sua conta followize conforme o print abaixo