Patch conversation custom field values

PATCH

/conversations/{uuid}/fields

Requer conversations:write. before compara todos os campos sob lock da conversa na mesma transação; ausência equivale a null. expected_uuid_crm confere o vínculo. Origem crm_mirror exige ambos e identifica a integração autenticada. Conflito retorna 409 sem gravação. 200 retorna readback. Selects espelhados aceitam somente IDs numéricos em string. Aliases mirror.idAlias são de leitura e só existem quando configurados; o PATCH do CRM pode repeti-los com o mesmo valor do select correspondente. date exige YYYY-MM-DD e datetime exige ISO 8601 com fuso explícito. 422 identifica o campo e o formato esperado, sem gravar nenhum campo.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200OK

application/json

Success

Bodyapplication/json

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠409Erro de Parâmetro

🟠422Erro de Parâmetro

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/conversations//fields' \
--header 'Content-Type: application/json' \
--data '{
    "custom_fields": {
        "property1": "string",
        "property2": "string"
    },
    "before": {
        "property1": "string",
        "property2": "string"
    },
    "expected_uuid_crm": "1aae5c78-f9ed-47b8-a836-ee9487d50a3f",
    "origin": "crm_mirror",
    "crm_terminal": true
}'

Response Example

200 - Exemplo 1

{
    "data": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "custom_fields": {
            "property1": "string",
            "property2": "string"
        }
    }
}

Modificado em 2026-10-22 18:13:52

Página anterior

Replace a conversation select list

Próxima página

Receive an event from Wazapi