Negócios

Visão geralEndpoints

No HubSpot, os negócios representam transações com contatos ou empresas. Os negócios são rastreados durante o processo de vendas nas fases do pipeline até serem conquistados ou perdidos. Os endpoints de negócios permitem controlar a criação e o gerenciamento de registros de negócios, bem como sincronizar dados de negócios entre o HubSpot e outros sistemas. 

Saiba mais sobre objetos, registros, propriedades e APIs de associações no guia Noções básicas do CRM. Para obter informações mais gerais sobre objetos e registros no HubSpot, saiba como gerenciar seu banco de dados do CRM.

Crie negócios

Para criar novos negócios, faça uma solicitação POST para /crm/v3/objects/deals.

Na solicitação, inclua os dados do negócio em um objeto de propriedades. Você também pode adicionar um objeto de associações para associar seu novo negócio a registros (por exemplo, contatos, empresas) ou atividades (por exemplo, reuniões, observações) existentes.

Propriedades

Os detalhes do negócio são armazenados nas propriedades do negócio. Existem propriedades de negócio padrão do HubSpot, mas você também pode criar propriedades personalizadas.

Ao criar um novo negócio, você deve incluir as seguintes propriedades na solicitação: dealname, dealstage e, caso tenha vários pipelines, pipeline. Se um pipeline não for especificado, o pipeline padrão será usado. 

Para exibir todas as propriedades disponíveis, você pode recuperar uma lista das propriedades de negócios da sua conta, fazendo uma solicitação GET para /crm/v3/properties/deals. Saiba mais sobre a API de propriedades.

Observação: você deve usar o ID interno de uma fase ou pipeline de negócios ao criar um negócio por meio da API. O ID interno também será retornado quando você recuperar negócios por meio da API. Você pode encontrar o ID interno de uma fase ou pipeline de negócios em nas configurações do pipeline de negócios.

Por exemplo, para criar um novo negócio, a solicitação pode ser semelhante à seguinte:

///Example request body { "properties": { "amount": "1500.00", "closedate": "2019-12-07T16:50:06.678Z", "dealname": "New deal", "pipeline": "default", "dealstage": "contractsent", "hubspot_owner_id": "910901" } }

Associações

Ao criar um novo negócio, você também pode associá-lo a registros ou atividades existentes. No objeto de associações, inclua os seguintes campos:

Use this table to describe parameters / fields
ParameterDescription
toObjectId

O ID do registro ou da atividade com o qual você deseja associar o negócio.

associationTypeId

Um identificador exclusivo para indicar o tipo de associação entre o negócio e o outro objeto ou atividade. Os tipos de associação padrão estão listados aqui, ou você pode recuperar o valor fazendo uma solicitação GET para /crm/v4/associations/{fromObjectType}/{toObjectType}/labels. Saiba mais sobre a API de associações.

Você também pode incluir o campo label para atribuir um rótulo de associação definido que descreve a associação. Saiba mais sobre como associar registros por meio da API de associações.

Por exemplo, para associar um novo negócio a um contato e uma empresa existentes, a solicitação seria parecida com a seguinte:

///Example request body { "properties": { "amount": "1500.00", "closedate": "2019-12-07T16:50:06.678Z", "dealname": "New deal", "pipeline": "default", "dealstage": "contractsent", "hubspot_owner_id": "910901" }, "associations": [ { "to": { "id": 201 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 5 } ] }, { "to": { "id": 301 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 3 } ] }] }

Recuperar negócios

Você pode recuperar negócios individualmente ou em lotes. Para recuperar um negócio individual, faça uma solicitação GET para /crm/v3/objects/deals/{dealId}.

Para solicitar uma lista de todos os negócios, faça uma solicitação GET para /crm/v3/objects/deals.

Para ambos os endpoints, você pode incluir os seguintes parâmetros de consulta no URL da solicitação: 

Use this table to describe parameters / fields
ParameterDescription
propriedades
Uma lista separada por vírgulas das propriedades a serem retornadas em resposta. Se o negócio solicitado não tiver um valor para uma propriedade, ele não será exibido na resposta.
associações

Uma lista separada por vírgulas de objetos para recuperar IDs associados. Todas as associações especificadas que não existem não serão retornadas na resposta. Saiba mais sobre a API de associações.

Saiba mais sobre a recuperação de negócios, clicando na guia Endpoints na parte superior deste artigo.

Atualizar negócios

Você pode atualizar negócios individualmente ou em massa. Para negócios existentes, o ID do negócio é um valor exclusivo que você pode usar para atualizar o negócio por meio da API.

Para atualizar um negócio individual por seu ID de negócio, faça uma solicitação  PATCH para /crm/v3/objects/deals/{dealId} e inclua os dados que deseja atualizar.

Associar negócios existentes a registros ou atividades

Para associar um negócio a outros registros do CRM ou uma atividade, faça uma solicitação PUT para  /crm/v3/objects/deals/{dealId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}. 

Para recuperar o valor associationTypeId, consulte esta lista de valores padrão ou faça uma solicitação GET para /crm/v4/associations/{fromObjectType}/{toObjectType}/labels.

Saiba mais sobre como associar registros com a API de associações.

Remover uma associação

Para remover uma associação entre um negócio e um registro ou uma atividade, faça uma solicitação DELETE para o seguinte URL: /crm/v3/objects/deals/{dealId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}.

Excluir negócios

Você pode excluir negócios individualmente ou em massa, o que adicionará o negócio à lixeira no HubSpot. Posteriormente, você pode restaurar o negócio no HubSpot.

Para excluir um negócio individual pelo seu ID, faça uma solicitação DELETE para /crm/v3/objects/deals/{dealId}.

Saiba mais sobre a exclusão em massa de negócios na guia Endpoints na parte superior deste artigo.

Este artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot..