Digitalk Developers
  1. Empresas do cliente
Raiz
  • Raiz
  • CRM
    • CRM — Overview
    • Genérico (data)
      • CRM - Genérico
      • Listar/filtrar registros (qualquer tabela do CRM)
      • Criar/atualizar registros (qualquer tabela do CRM)
      • Hard-delete (não permitido para tabelas company)
    • Empresas Relacionadas
      • CRM - Empresas relacionadas
      • Tipos de relacionamento disponíveis
      • Listar relacionamentos de uma empresa (ambas as direções)
      • Criar relacionamento entre duas empresas
      • Alterar o tipo do relacionamento
      • Inativar relacionamento (reversível)
      • Excluir relacionamento (hard-delete)
    • Ticket ↔ Empresa
      • CRM - Ticket <-> Empresa
      • Empresas elegíveis para o ticket
      • Vincular / trocar a empresa do ticket
    • Templates
      • CRM - Templates
      • Listar templates do tenant (apenas IDs, sem fields)
      • Detalhe completo do template (com fields)
      • Pesquisa formatada por scope (CRMSearchResult)
    • Empresas do cliente
      • Listar tipos de relacionamento
        GET
      • Listar empresas de um cliente
        GET
      • Vincular empresa ao cliente
        POST
      • Trocar a empresa principal
        PATCH
      • Alterar tipo de relacionamento
        PATCH
      • Inativar vínculo
        PATCH
      • Reativar vínculo
        PATCH
      • Excluir vínculo
        DELETE
  • Workflow
    • Workflow - Overview
    • Tickets
      • Workflow - Tickets
      • Detalhe completo do ticket (mensagens, SLA, fases, customer, empresa, business)
      • Criar ticket (básico, com integração CRM opcional)
      • Criar ticket com auto-vínculo / criação de customer via contato
      • Movimentar ticket entre fases (ou finalizar)
      • Atualizar dados do ticket (nome, descrição, valor)
      • Vincular cliente CRM a um ticket existente
      • Adicionar nota ou mensagem ao ticket
      • Atribuir ou transferir o responsável do ticket
    • Workspaces & Workflows
      • Workflow - Workspaces & Workflows
      • Listar workspaces e workflows acessíveis ao usuário
      • Listar fases de um workflow
      • Listar tickets de uma ou mais fases (paginado)
  • Webhooks
    • Eventos
      • Catálogo de eventos disponíveis
      • 📨 [Contrato] Evento entregue na sua URL
    • Assinaturas
      • Listar webhooks cadastrados
      • Criar webhook (o secret aparece UMA única vez)
      • Testar conectividade de uma URL
      • Detalhar webhook
      • Atualizar webhook
      • Ativar/desativar webhook (toggle)
      • Remover webhook (soft delete)
    • Entregas
      • Log de entregas de uma assinatura
      • Reprocessar uma entrega
      • Reprocessar TODAS as entregas com falha
    • Integrações
      • Voz IA (ElevenLabs)
        • Criar ou atualizar a integração ElevenLabs
        • Consultar a integração ElevenLabs
        • Alterar a integração ElevenLabs (secret, toggle, allowlist)
        • Remover a integração ElevenLabs
        • Webhook pós-chamada (chamado pela ElevenLabs)
  • Configurações
    • Canais
      • WhatsApp oficial
        • Listar conexões de WhatsApp (a tela Canais › WhatsApp oficial)
        • Listar números disponíveis de uma WABA
        • Criar conexão de WhatsApp oficial
        • Conectar o número oficial (ativar a conexão)
      • Telefonia
        • Anexar gravação de ligação (telefonia de terceiros)
        • Registrar CSAT de ligação
        • Consultar status da gravação enviada
    • Templates
      • WhatsApp oficial
        • Listar templates HSM (a tela Templates › WhatsApp oficial)
        • Criar template HSM (+ Novo modelo)
        • Detalhar template
        • Atualizar template
        • Excluir template
        • Sincronizar templates com a Meta
        • Upload de mídia para o header do template
      • RCS
        • Listar templates de RCS
    • Base de dados
      • Modelo de colunas do CSV
      • Importar base (CSV) para uma tabela do CRM
      • Acompanhar as importações (validar o resultado)
      • Erros de uma importação
      • Exportar os erros em planilha
  • Raiz
    • Workflow
      • Tarefas
        • Criar tarefa
        • Listar tarefas
        • Resumo de tarefas
        • Consultar tarefa
        • Editar tarefa
        • Concluir tarefa
        • Cancelar (excluir) tarefa
        • Silenciar alarme
        • Tarefas do ticket
  1. Empresas do cliente

Vincular empresa ao cliente

POST
{{baseURL}}/api/v2/cliente-empresas
Última modificação:2026-10-29 19:26:50
Cria um vínculo entre o cliente e uma empresa, com tipo.

Regras#

id_cliente, id_empresa e tipo_de_relacionamento são obrigatórios.
tipo_de_relacionamento é um value de GET /types.
A empresa precisa existir, não estar excluída e estar ativa.
O mesmo cliente não pode ter duas vezes a mesma empresa.

Já como principal#

Com principal: true, o vínculo é criado e vira a principal na mesma operação.
Nesse caso mande id_empresa_esperada com a principal que você leu
(null se o cliente não tinha): se ela mudou no meio do caminho, a resposta é
409 e nada é gravado.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples
{
    "id_cliente": 4520,
    "id_empresa": 12,
    "tipo_de_relacionamento": "consultor"
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff 'https://api-{tenant}.digitalk.com.br/api/v2/cliente-empresas' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)' \
--header 'Content-Type: application/json' \
--data '{
    "id_cliente": 4520,
    "id_empresa": 12,
    "tipo_de_relacionamento": "consultor"
}'

Respostas

🟢201Criado
application/json
Vínculo criado. principal indica se ele é a principal.
Bodyapplication/json

Exemplo
{
    "ok": true,
    "data": {
        "id": 31,
        "id_cliente": 4520,
        "id_empresa": 12,
        "tipo_de_relacionamento": "consultor",
        "ativo": true,
        "principal": false,
        "created_by": 9800,
        "updated_by": null,
        "deleted_at": null
    }
}
🟠400Pedido Inválido
🟠401Não Autorizado
🟠404Registo Não Encontrado
🟠409
🟠422Erro de Parâmetro
Modificado em 2026-10-29 19:26:50
Página anterior
Listar empresas de um cliente
Próxima página
Trocar a empresa principal
Built with