---
title: "Negociação atualizada"
method: POST
path: "crm_deal_updated"
tags: ["crm-v2-webhook-events", "crm-v2-deals"]
---

# Negociação atualizada

`POST crm_deal_updated` (webhook)

Esse evento de webhook é disparado quando uma negociação é atualizada.

## Payload

- object
  - `event_name` 'crm_deal_updated': Tipo de evento do webhook.
  - `event_timestamp` string, date-time: A data em que ocorreu o evento que acionou o webhook.
  - `transaction_uuid` string, uuid: Identificador único do evento.
  - `document` object: Documento relacionado ao evento do webhook.
    - `id` string: Identificador único.
    - `name` string: Nome da negociação.
    - `amount_monthly` number, float: Valor recorrente da negociação.
    - `amount_unique` number, float: Valor único da negociação.
    - `amount_total` number, float: Valor total da negociação.
    - `prediction_date` string, date: Data de previsão de fechamento da negociação.
    - `rating` integer: Qualificação da negociação.
    - `status` 'won' | 'lost' | 'ongoing' | 'paused': Status da negociação.
    - `closed_at` string, date-time: Data de fechamento da negociação.
    - `deal_pipeline` object: Funil de vendas da negociação.
      - `id` string: Identificador único.
      - `name` string: Nome do funil de vendas.
    - `deal_stage` object: Etapa do funil de vendas da negociação.
      - `id` string: Identificador único.
      - `name` string: Nome da etapa do funil de vendas.
      - `nickname` string: Sigla da etapa do funil de vendas.
      - `order` integer: Ordem da etapa do funil de vendas.
      - `created_at` string, date-time: Data de criação da etapa do funil de vendas.
      - `updated_at` string, date-time: Data de atualização da etapa do funil de vendas.
    - `user` object: Usuário responsável pela negociação.
      - `id` string: Identificador único.
      - `name` string: Nome do usuário.
      - `email` string: Email do usuário.
      - `avatar_url` string: URL do avatar do usuário.
    - `deal_source` object: Fonte da negociação.
      - `id` string: Identificador único.
      - `name` string: Nome da fonte.
    - `campaign` object: Campanha da negociação.
      - `id` string: Identificador único.
      - `name` string: Nome da campanha.
    - `deal_lost_reason` object: Motivo de perda da negociação.
      - `id` string: Identificador único.
      - `name` string: Nome do motivo de perda.
    - `deal_products` object[]: Produtos da negociação.
      - `product_id` string: Identificador único.
      - `name` string: Nome do produto.
      - `description` string: Descrição do produto.
      - `price` number, float: Preço do produto.
      - `quantity` number, float: Quantidade do produto.
      - `discount` number, float: Desconto do produto.
      - `discount_type` string: Tipo de desconto.
      - `total` number, float: Preço total do produto.
    - `deal_custom_fields` object[]: Campos personalizados da negociação.
      - `value` string: Valor do campo personalizado.
      - `custom_field` object: Campo personalizado.
        - `id` string: Identificador único.
        - `label` string: Nome do campo personalizado.
        - `required` boolean: Se o campo é obrigatório.
        - `unique` boolean: Se o campo é único.
        - `opts` string[]: Opções do campo personalizado.
        - `type` string: Tipo do campo personalizado.
    - `created_at` string, date-time: Data de criação da negociação.
    - `updated_at` string, date-time: Data de atualização da negociação.

## Acknowledgement `2XX`

O evento é considerado aceito retornando qualquer código de resposta 2XX.

## Other responses

- `default`: O evento é considerado rejeitado para qualquer outro código de resposta. A emissão do evento será repetida posteriormente.

---

[API](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/revisions/10d0a25b8c54?raw)
