IntegrazioniAPI
Una chiamata dopo l'appuntamento o l'ordine, e Citypicked chiede la recensione. Valutazioni e feedback privato tornano come webhook.
Richiesta
POST /v1/requests Authorization: Bearer cp_live_… Idempotency-Key: booking-4711 { "channel": "sms", "consent": true, "contacts": [{ "name": "Emma Conti", "phone": "+12015550123" }] }
Risposta 201
{ "created": 1,
"results": [{ "outcome": "created", "request_id": "…" }] }Webhook
Iscrivi un URL agli eventi che ti servono. Ogni invio è firmato e arriva in pochi secondi.
Verifica la firma
Citypicked-Signature: t=1762594200,v1=5f2c… const expected = crypto .createHmac("sha256", secret) .update(`${t}.${rawBody}`) .digest("hex");
Se il tuo URL non risponde con un 2xx, riproviamo altre sei volte nell'arco di circa 18 ore.
Endpoint
La lettura funziona con qualsiasi chiave. Per inviare serve una chiave con il permesso di invio.
Prima di fare la prima chiamata
Niente in più. La lettura funziona con ogni piano, l'invio tramite l'API dal piano Pro. Gli SMS usano crediti come nell'app, le e-mail no.
Sì. Con send_at programmi con un anticipo massimo di 30 giorni. Fino ad allora basta una chiamata per annullarla, per esempio se salta un appuntamento.
No. Puoi anche recuperare richieste e feedback, con since solo le novità. I webhook ti evitano di controllare di continuo e arrivano subito.
Con channel impostato su whatsapp ricevi un link. Il team lo apre sul proprio telefono e invia il messaggio di persona, come nell'app.
Sì, la descrizione OpenAPI 3.1 di ogni endpoint, disponibile senza chiave.
La tua prima richiesta parte tra cinque minuti.