---
title: "Integração com Followize (Dealerspace)"
description: "Veja como funciona a integração entre Duotalk e Followize, onde é enviado as informações do contato."
url: https://ajuda.duotalk.io/pt/articles/145-integracao-com-followize-dealerspace
collection: "Integrações"
updated: 2026-10-21
language: pt
---

# Integração com Followize (Dealerspace)

Veja como funciona a integração entre Duotalk e Followize, onde é enviado as informações do contato.

A Duotalk permite integração direta com o CRM Followize, agora dealerspace, em [diferentes tipos de processos](https://ajuda.followize.com.br/hc/pt-br/articles/4409221447191-Quais-s%C3%A3o-as-diferen%C3%A7as-entre-os-processos-de-conta-no-Followize).

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.
        
    
    ![](https://staticfiles.gleap.io/ghelparticle/NxdIOr5Ui57D47qjYFjl565sftCW1Utx4EkmS8R8x1PRx1AegCgAoPiiqjlPFuZy9rW2siazKiR.png)
    
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.
        

![](https://staticfiles.gleap.io/ghelparticle/DCbdmIGbc5zBbM9IiXMyinRk8HAD07pOQdg1IMjXlYImwv0E99VzcFphfEnGnaPrLvHyQJIs8tj.png)

### 🧾 Payload de Exemplo — Usuário Vendedor

```json
{
  "clientKey": "SEU_CLIENT_KEY",
  "conversionGoal": "Teste processo dois",
  "name": "Nome do Lead",
  "email": "lead@email.com",
  "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

```javascript
{
  "clientKey": "SEU_CLIENT_KEY",
  "conversionGoal": "Teste processo dois",
  "name": "Nome do Lead",
  "email": "lead@email.com",
  "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
    

![](https://staticfiles.gleap.io/ghelparticle/bBrQLA1Pg7FEEFrPi4aLOVaunU4QCQ9giQRI7dgkp1S1k74CH45ic7ozy0ZaLWTl0cnPGwh8dR4.png)

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

![](https://staticfiles.gleap.io/ghelparticle/bAmgKoz9xsHaL8RJtaZlyElw4k6xP4APc77HtgV4e2va3EuLSzO7O0DOzVz6QVYsK5Q4TWnRO4Z.png)