Criar negociação

Definição de Proprietário

Tipos ("type") válidos de proprietário são:

user: Refere-se a um usuário. Para usuários, o campo ID é obrigatório
team: Refere-se a uma equipe. Para equipes, o campo ID é obrigatório
all: Refere-se a qualquer usuário da conta
all_users: Refere-se a qualquer usuário não-administrador da conta
all_admins: Refere-se a qualquer usuário administrador da conta
owner: Refere-se a um usuário, o campo email é obrigatório. O campo ID não é obrigatório.

Observação: Se o campo "User ID" estiver preenchido, deixaremos de levar em conta a distribuição geral. Isso ocorre porque interpretamos que a negociação deve ser direcionada especificamente para o usuário identificado.

Exemplo:
"distribution_settings" : { "deal_stage": { "id": "000000000000000000530" }, "owner": { "type": "owner", "email": "[email protected]" } }


Associação de Contatos existentes a Negociação

A API de Criar Negociações permite criar novos Contatos para vinculá-los a uma Negociação ou associar Contatos já existentes no CRM a uma Negociação, tudo em uma única requisição.

Para vincular o Contato existente utilize o parâmetro set_contacts, como neste exemplo com um payload básico:

{ "deal": { "name": "Nome da Negociação" }, "set_contacts": [ { "id": "CONTACT_ID" } ] }

❗️

O erro 404 Not Found indica que um ID enviado na requisição é inválido.

Revise os IDs informados na requisição e se certifique de que o valor é válido, ou seja, é referente à uma entidade ou campo da sua conta no CRM.

Language
Click Try It! to start a request and see the response here!