> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mycentralino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modifica un agente

> Cambia nome, istruzioni, orari, regole di risposta di un Agente AI di MyFlow, o lo accende e lo spegne

# PATCH /v1/whatsapp/agents/\{id}

Modifica un **Agente AI**. Manda solo i campi da cambiare: quelli assenti restano come sono. La risposta è l'agente aggiornato, con l'elenco dei campi cambiati davvero.

Con `"enabled": false` spegni l'agente su tutti i suoi numeri in una volta. Con `"enabled": true` lo riaccendi. Per sceglierne i numeri ci sono le rotte di [attivazione](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-attach.md) e [disattivazione](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-detach.md).

> [!WARNING]
>
> L'agente risponde da solo ai tuoi clienti. Una modifica alle istruzioni vale dal messaggio successivo, anche nelle conversazioni già aperte. Fai le prove prima con un agente spento o senza numeri, con la card **Prova** del pannello.

## Parametri

| Parametro | Tipo | Obbligatorio | Descrizione |
| - | - | - | - |
| `id` | int | ✅ | ID dell'agente, nel percorso |

## Request Body

Gli stessi campi della [creazione](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-create.md#request-body), tutti facoltativi. Almeno uno è necessario.

| Campo | Tipo | Descrizione |
| - | - | - |
| `name` | string | Da 1 a 80 caratteri, su una riga |
| `instructions` | string \| null | Fino a 16.000 caratteri. `""` o `null` le svuota |
| `handoff_message` | string | Da 1 a 500 caratteri |
| `schedule` | object | `{"mode": "always"}` oppure `{"mode": "slots", "slots": {…}}`. Vedi sotto |
| `max_replies` | int | Da 1 a 50 |
| `reply_delay_seconds` | int | Da 5 a 600 |
| `human_pause_minutes` | int | Da 0 a 1440 |
| `enabled` | boolean | Accende o spegne l'agente su tutti i suoi numeri |

### Cambiare l'orario

* `schedule.mode` è sempre obbligatorio dentro `schedule`.
* `schedule.slots`, se c'è, **sostituisce tutta la settimana**: un giorno che non mandi resta senza fasce. Per cambiare un giorno solo, leggi prima le fasce con il [dettaglio](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-detail.md) e rimandale tutte.
* Senza `slots` le fasce salvate restano come sono. Così `{"schedule": {"mode": "always"}}` mette l'agente sempre attivo senza perdere le fasce, e `{"schedule": {"mode": "slots"}}` lo rimette sulle fasce che aveva, se ne ha almeno una.

Le regole di ogni fascia sono in [Crea un agente](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-create.md).

## Richiesta

```bash cURL theme={null}
curl -X PATCH "https://api.mycentralino.com/v1/whatsapp/agents/7" \
  -H "X-API-KEY: sk_mycentralino_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
      "instructions": "Sei l'\''assistente dello Studio Rossi. Rispondi in modo cortese e breve. Dal 20 al 31 dicembre lo Studio è chiuso: dillo a chi chiede un appuntamento.",
      "human_pause_minutes": 60
  }'
```

```php PHP theme={null}
<?php
$data = [
    'instructions' => "Sei l'assistente dello Studio Rossi. Dal 20 al 31 dicembre lo Studio è chiuso.",
    'human_pause_minutes' => 60,
];

$ch = curl_init('https://api.mycentralino.com/v1/whatsapp/agents/7');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: sk_mycentralino_your_api_key',
        'Content-Type: application/json'
    ]
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
```

```python Python theme={null}
import requests

headers = {'X-API-KEY': 'sk_mycentralino_your_api_key'}
data = {
    "instructions": "Sei l'assistente dello Studio Rossi. Dal 20 al 31 dicembre lo Studio è chiuso.",
    "human_pause_minutes": 60
}
response = requests.patch('https://api.mycentralino.com/v1/whatsapp/agents/7', headers=headers, json=data)
print(response.json())
```

## Risposta

`200 OK` con l'agente aggiornato, nella forma del [dettaglio](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-detail.md), più `changed`.

```json theme={null}
{
  "success": true,
  "data": {
    "id": 7,
    "name": "Assistente Studio",
    "enabled": true,
    "active_now": true,
    "schedule": {"mode": "always"},
    "numbers": [{"phone": "+390212345678", "name": "Studio Rossi"}],
    "knowledge_docs": 4,
    "replies_7d": 37,
    "instructions": "Sei l'assistente dello Studio Rossi. Rispondi in modo cortese e breve. Dal 20 al 31 dicembre lo Studio è chiuso: dillo a chi chiede un appuntamento.",
    "handoff_message": "Ti passo a un collega dello Studio, ti risponderà appena possibile.",
    "max_replies": 8,
    "reply_delay_seconds": 20,
    "human_pause_minutes": 60,
    "created_at": "2026-11-12T18:20:05+01:00",
    "updated_at": "2026-12-15T10:12:30+01:00",
    "changed": ["instructions", "human_pause_minutes"]
  }
}
```

| Campo | Tipo | Descrizione |
| - | - | - |
| `changed` | string\[] | I campi cambiati davvero. Un campo mandato con lo stesso valore di prima non c'è. Elenco vuoto = non è cambiato niente, e la chiamata non lascia traccia |

Ogni modifica lascia una riga nel Log attività del pannello, con i nomi dei campi cambiati. Il testo delle istruzioni non viene scritto.

## Errori

### 404 - agent\_not\_found

Non c'è un agente con questo `id` su questo account.

### 422 - empty\_update

Il body non ha campi da modificare.

### 422 - invalid\_schedule

`schedule` non ha la forma giusta, oppure `mode: "slots"` senza fasce né mandate né già salvate. Il messaggio dice cosa correggere.

### 422 - invalid\_name / invalid\_instructions / invalid\_handoff\_message / invalid\_max\_replies / invalid\_reply\_delay\_seconds / invalid\_human\_pause\_minutes / invalid\_enabled

Un campo non valido: le regole sono in [Crea un agente](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-create.md#request-body). Gli errori sui numeri portano `min` e `max`.

### 422 - unknown\_fields

Un campo che non esiste, `provider` e `model` compresi. L'errore elenca i campi sbagliati in `fields` e quelli ammessi in `allowed`.

Se il body ha un errore, non si salva niente: nemmeno i campi giusti.

Gli errori comuni a tutte le rotte sono nell'[introduzione](https://docs.mycentralino.com/mycentralino-api/whatsapp-introduction.md#codici-di-errore).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.