Colaboradores

O que são colaboradores

Colaboradores (sellers) são os consultores e atendentes da sua loja que interagem com os leads na plataforma. Via API você pode gerenciar a equipe completa — criar, atualizar, ativar/desativar e remover colaboradores.

Relação com leads

Cada lead pode ter um colaborador responsável (seller_id). Essa atribuição:

Aparece na plataforma para indicar quem está cuidando do lead
Filtra leads por responsável nos relatórios
Identifica mensagens enviadas pelo consultor no histórico da conversa

Listar colaboradores

curl https://api.cordialy.ai/integrations/v1/sellers \
  -H "X-API-Key: SUA_KEY"

[
  {
    "id": "seller-001",
    "name": "Ana Lima",
    "whatsapp_id": "5511988887777",
    "is_active": true
  },
  {
    "id": "seller-002",
    "name": "Carlos Mendes",
    "whatsapp_id": "5511977776666",
    "is_active": true
  }
]

Criar colaborador

curl -X POST https://api.cordialy.ai/integrations/v1/sellers \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Fernanda Costa",
    "whatsapp_id": "5511966665555"
  }'

const seller = await fetch('https://api.cordialy.ai/integrations/v1/sellers', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.CORDIALY_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'Fernanda Costa',
    whatsapp_id: '5511966665555',
  }),
}).then(r => r.json());

Cada plano tem um limite de colaboradores ativos. Se a loja já estiver no teto, a criação retorna 400 com uma mensagem indicando o limite atual — faça upgrade de plano ou desative um colaborador existente antes de criar outro.

Atribuir lead a um colaborador

Use o seller_id retornado ao atualizar um lead:

curl -X PATCH https://api.cordialy.ai/integrations/v1/leads/LEAD_ID \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seller_id": "seller-001"}'

Para remover a atribuição:

curl -X PATCH https://api.cordialy.ai/integrations/v1/leads/LEAD_ID \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seller_id": null}'

Filtrar leads por colaborador

curl "https://api.cordialy.ai/integrations/v1/leads?seller_id=seller-001" \
  -H "X-API-Key: SUA_KEY"

Ativar / desativar colaborador

Desativar é preferível a deletar — mantém o histórico intacto:

# Desativar
curl -X PATCH https://api.cordialy.ai/integrations/v1/sellers/SELLER_ID \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_active": false}'

# Reativar
curl -X PATCH https://api.cordialy.ai/integrations/v1/sellers/SELLER_ID \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_active": true}'

Remover colaborador

curl -X DELETE https://api.cordialy.ai/integrations/v1/sellers/SELLER_ID \
  -H "X-API-Key: SUA_KEY"

Ao remover um colaborador, os leads atribuídos a ele ficam sem responsável (seller_id = null). Prefira desativar se quiser manter o histórico de atribuições.

Padrões de integração

Sincronizar equipe do RH

Quando um colaborador é contratado ou demitido no sistema de RH, reflita na Cordialy:

// Novo colaborador contratado
async function onColaboradorContratado(funcionario) {
  await fetch('https://api.cordialy.ai/integrations/v1/sellers', {
    method: 'POST',
    headers: { 'X-API-Key': process.env.CORDIALY_API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ name: funcionario.nome, whatsapp_id: funcionario.whatsapp }),
  });
}

// Colaborador desligado
async function onColaboradorDesligado(sellerId) {
  await fetch(`https://api.cordialy.ai/integrations/v1/sellers/${sellerId}`, {
    method: 'PATCH',
    headers: { 'X-API-Key': process.env.CORDIALY_API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ is_active: false }),
  });
}

Distribuir leads automaticamente

Ao criar um lead no seu CRM, atribua um colaborador com base em regras de distribuição:

async function distribuirLead(lead, sellers) {
  // Round-robin simples
  const index = lead.sequencia % sellers.length;
  const seller = sellers[index];

  await fetch(`https://api.cordialy.ai/integrations/v1/leads/${lead.id}`, {
    method: 'PATCH',
    headers: { 'X-API-Key': process.env.CORDIALY_API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ seller_id: seller.id }),
  });
}

Início

Guias

Exemplos

O que são colaboradores

Relação com leads

Listar colaboradores

Criar colaborador

Atribuir lead a um colaborador

Filtrar leads por colaborador

Ativar / desativar colaborador

Remover colaborador

Padrões de integração

​O que são colaboradores

​Relação com leads

​Listar colaboradores

​Criar colaborador

​Atribuir lead a um colaborador

​Filtrar leads por colaborador

​Ativar / desativar colaborador

​Remover colaborador

​Padrões de integração

O que são colaboradores

Relação com leads

Listar colaboradores

Criar colaborador

Atribuir lead a um colaborador

Filtrar leads por colaborador

Ativar / desativar colaborador

Remover colaborador

Padrões de integração