Replace AI duty settings

PUT

/settings/ai-duty

Requires explicit ai_agents:write, active integration actor with settings.general and Business plan. Replaces mode, agentUuid, channels and dailyLimit; plantao is replaced when sent and kept when omitted (inside it, omitted triggers and rules keep the saved values). Tenant comes only from token. Enabling allows future AI calls; only plantao sends to leads, never reassigning or transferring.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200OK

application/json

Company AI duty configuration

Bodyapplication/json

🟠401Não Autorizado

🟠403Proibido

🟠422Erro de Parâmetro

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/settings/ai-duty' \
--header 'Content-Type: application/json' \
--data '{
    "summaryNotesEnabled": true,
    "suggestionsEnabled": true,
    "mode": "desligado",
    "agentUuid": "7575cf62-4caa-4e7d-b264-bc807d805a6c",
    "channels": [
        "whatsapp"
    ],
    "dailyLimit": 60,
    "plantao": {
        "retomadaContextual": true,
        "leituraContexto": true,
        "leituraModelo": "claude-haiku-5-5",
        "umaVozPorConversa": true,
        "janelaContato": {
            "inicio": "08:00",
            "fim": "22:00"
        },
        "respostaRapidaMinutos": 20,
        "limiteDiario": 300,
        "groups": [
            {
                "groupUuid": "71fee78a-8074-4708-b2ba-44fae6164fac",
                "retomadaModo": "nota",
                "ausenteImediato": false,
                "presenteSemRespostaMinutos": null,
                "supervisorUuids": []
            }
        ],
        "retomadaMinutos": 60,
        "retomadaCadenciaMinutos": [
            60,
            240
        ],
        "retomadaJanela": {
            "inicio": "08:00",
            "fim": "22:00"
        },
        "retomadaLimiteDiario": 100,
        "notaForaDoPlantao": false,
        "gatilhoAusente": true,
        "carenciaDonoAtivo": {
            "janelaMinutos": 60,
            "esperaMinutos": 3
        },
        "gatilhoRetomada": true,
        "regras": {
            "r1": true,
            "r2": true,
            "r3": true,
            "r4": true,
            "r5": true
        }
    }
}'

Response Example

200 - Exemplo 1

{
    "data": {
        "summaryNotesEnabled": true,
        "suggestionsEnabled": true,
        "mode": "desligado",
        "agentUuid": "7575cf62-4caa-4e7d-b264-bc807d805a6c",
        "channels": [
            "whatsapp"
        ],
        "dailyLimit": 60,
        "plantao": {
            "retomadaContextual": true,
            "leituraContexto": true,
            "leituraModelo": "claude-haiku-5-5",
            "umaVozPorConversa": true,
            "janelaContato": {
                "inicio": "08:00",
                "fim": "22:00"
            },
            "respostaRapidaMinutos": 20,
            "limiteDiario": 300,
            "groups": [
                {
                    "groupUuid": "71fee78a-8074-4708-b2ba-44fae6164fac",
                    "retomadaModo": "nota",
                    "ausenteImediato": false,
                    "presenteSemRespostaMinutos": null,
                    "supervisorUuids": []
                }
            ],
            "retomadaMinutos": 60,
            "retomadaCadenciaMinutos": [
                60,
                240
            ],
            "retomadaJanela": {
                "inicio": "08:00",
                "fim": "22:00"
            },
            "retomadaLimiteDiario": 100,
            "notaForaDoPlantao": false,
            "gatilhoAusente": true,
            "carenciaDonoAtivo": {
                "janelaMinutos": 60,
                "esperaMinutos": 3
            },
            "gatilhoRetomada": true,
            "regras": {
                "r1": true,
                "r2": true,
                "r3": true,
                "r4": true,
                "r5": true
            }
        }
    }
}

Modificado em 2026-10-19 02:17:39

Página anterior

Read AI duty settings

Próxima página

Preview or dismiss open AI seller tasks in bulk