Atualização da API: Múltiplos contatos por oportunidade

Daria da Flowlu

Gerente Líder de Marketing de Produto

28 de janeiro de 2026

4 min de leitura

Este post explica o que mudou, como a nova abordagem funciona e o que os usuários da API precisam saber.

O que mudou ao criar vínculos de oportunidades

Antes

Ao criar ou atualizar uma oportunidade, os vínculos com contatos e organizações eram definidos diretamente usando campos da própria oportunidade:

• customer_id — usado para vincular uma organização
• contact_id — usado para vincular um contato

Essa abordagem permitia vincular apenas duas contas de CRM a uma oportunidade: uma organização e um contato.

Como resultado, não era possível associar vários contatos à mesma oportunidade.

Agora

Um novo endpoint foi introduzido:
crm/lead_accounts/create

Esse endpoint foi projetado especificamente para criar vínculos entre contas de CRM e uma oportunidade.

A principal diferença em relação à abordagem anterior é o suporte a múltiplas contas de CRM vinculadas a uma única oportunidade, o que permite vincular vários contatos à mesma oportunidade.

Essa mudança oferece uma forma mais flexível e explícita de gerenciar os relacionamentos das oportunidades.

Estrutura da requisição

O endpoint aceita os seguintes parâmetros:

• lead_id — ID da oportunidade à qual a conta será vinculada (obrigatório)
• account_id — ID da conta de CRM que será vinculada (obrigatório)
• account_type — tipo de conta de CRM (obrigatório):

1 — organização

2 — contato

• created_at — campo do sistema, preenchido automaticamente
• updated_at — campo do sistema, preenchido automaticamente

O que mudou ao recuperar dados da oportunidade

Antes

Ao recuperar uma oportunidade, a resposta incluía:

• customer_id
• contact_id

Isso permitia recuperar apenas duas contas de CRM vinculadas: uma organização e um contato.

Agora

Os campos customer_id e contact_id não são mais retornados como parte da entidade da oportunidade e não são mais usados para recuperar vínculos com contas de CRM.

Para obter informações sobre as contas de CRM vinculadas a uma oportunidade, a API agora fornece endpoints dedicados:

• crm/lead_accounts/get/{id} — recuperar um vínculo específico entre oportunidade e conta
• crm/lead_accounts/list — recuperar todas as contas de CRM vinculadas a uma oportunidade

Essa abordagem oferece suporte total a múltiplos vínculos de contatos e é a forma atual e suportada de acessar os dados de relacionamento.

Compatibilidade retroativa

A compatibilidade retroativa não é suportada.

Se sua integração depende de:

• definir customer_id ou contact_id ao criar oportunidades, ou
• ler esses campos nas respostas das oportunidades,

ela deve ser atualizada para usar a nova abordagem da API.

Se você não usa a API da Flowlu, esta atualização não afeta você.

Documentação

Os detalhes técnicos completos estão disponíveis na documentação da API.