Crea o aggiorna una prenotazione

POSThttps://app.sendapp.ai/api/bookings

Inserisce una prenotazione nell'Agenda di SendApp. Da lì partono i promemoria configurati (WhatsApp, SMS o email) e, se attivi, i richiami.

Serve alle piattaforme di prenotazione che preferiscono inviarci i dati invece di essere interrogate: una chiamata quando qualcosa cambia, e i promemoria partono da soli.

È idempotente. Il campo reference è il TUO identificativo: inviando due volte la stessa prenotazione la aggiorni, non la duplichi. Un tentativo ripetuto dopo un timeout non fa mai partire due promemoria allo stesso cliente.

Se il tuo account SendApp ha più account collegati, il campo token è obbligatorio: serve a dire su quale agenda finisce la prenotazione. Con un solo account puoi ometterlo.

Parámetros

apikey obligatorio

La tua API Key (in alternativa: header X-API-Key).

token opcional

Token dell'account su cui inserire la prenotazione. Obbligatorio se ne hai più di uno.

reference obligatorio

Il tuo identificativo della prenotazione. Reinviandolo aggiorni la stessa prenotazione.

start_time obligatorio

Data e ora di inizio. Accetta 2026-09-12 20:30 oppure ISO 8601 (2026-09-12T20:30:00+02:00). Senza fuso indicato viene letta nel fuso dell'account.

end_time opcional

Data e ora di fine. Se manca viene calcolata a un'ora dopo l'inizio.

name obligatorio

Nome del cliente.

phone opcional

Telefono in formato internazionale. Obbligatorio se non passi email.

email opcional

Email del cliente. Obbligatoria se non passi phone.

people opcional

Numero di persone: finisce nelle note della prenotazione.

notes opcional

Note libere (es. "tavolo vicino alla finestra").

location opcional

Sede o sala, se ne hai più di una.

status opcional

confirmed (predefinito) oppure cancelled.

timezone opcional

Fuso orario della prenotazione (es. Europe/Rome). Se manca si usa quello dell'account.

Solicitud

curl -X POST https://app.sendapp.ai/api/bookings \
  -H 'X-API-Key: LA_TUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "IL_TUO_ACCOUNT_TOKEN",
    "reference": "PRE-10432",
    "start_time": "2026-09-12 20:30",
    "name": "Mario Rossi",
    "phone": "+393331234567",
    "people": 4,
    "notes": "Tavolo vicino alla finestra"
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/bookings');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: LA_TUA_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'token'      => 'IL_TUO_ACCOUNT_TOKEN',
        'reference'  => 'PRE-10432',
        'start_time' => '2026-09-12 20:30',
        'name'       => 'Mario Rossi',
        'phone'      => '+393331234567',
        'people'     => 4,
    ]),
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

await fetch('https://app.sendapp.ai/api/bookings', {
  method: 'POST',
  headers: {
    'X-API-Key': 'LA_TUA_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    token: 'IL_TUO_ACCOUNT_TOKEN',
    reference: 'PRE-10432',
    start_time: '2026-09-12 20:30',
    name: 'Mario Rossi',
    phone: '+393331234567',
    people: 4,
  }),
});

Respuesta (200 OK)

{
  "status": "success",
  "created": true,
  "booking": {
    "reference": "PRE-10432",
    "token": "IL_TUO_ACCOUNT_TOKEN",
    "name": "Mario Rossi",
    "phone": "+393331234567",
    "email": null,
    "start_time": "2026-09-12 20:30:00",
    "end_time": "2026-09-12 21:30:00",
    "timezone": "Europe/Rome",
    "status": "confirmed",
    "notes": "Tavolo vicino alla finestra · 4 persone · REF PRE-10432"
  }
}

Error

{
  "status": "error",
  "message": "start_time is not a valid date. Use \"2026-09-12 20:30\" or an ISO 8601 value."
}