Una llamada después de la cita o del pedido, y Citypicked pide la reseña. Las valoraciones y los comentarios privados vuelven como webhooks.
Petición
POST /v1/requests Authorization: Bearer cp_live_… Idempotency-Key: booking-4711 { "channel": "sms", "consent": true, "contacts": [{ "name": "Lucía Martín", "phone": "+12015550123" }] }
Respuesta 201
{ "created": 1,
"results": [{ "outcome": "created", "request_id": "…" }] }Webhooks
Suscribe una URL a los eventos que necesites. Cada envío va firmado y llega en segundos.
Comprobar la firma
Citypicked-Signature: t=1762594200,v1=5f2c… const expected = crypto .createHmac("sha256", secret) .update(`${t}.${rawBody}`) .digest("hex");
Si tu URL no responde con un 2xx, lo intentamos seis veces más durante unas 18 horas.
Endpoints
Leer funciona con cualquier clave. Para enviar hace falta una clave con permiso de envío.
Antes de la primera llamada
Nada extra. Leer funciona con todos los planes; enviar a través de la API, desde Pro. Los SMS gastan créditos como en la app, los correos no.
Sí. Con send_at programas con hasta 30 días de antelación. Hasta entonces, una llamada la cancela, por ejemplo si se cae una cita.
No. También puedes consultar solicitudes y comentarios, con since para ver solo lo nuevo. Los webhooks te ahorran las consultas periódicas y llegan al instante.
Con channel en whatsapp recibes un enlace de vuelta. El equipo lo abre en su propio móvil y envía el mensaje él mismo, como en la app.
Sí, la descripción OpenAPI 3.1 de todos los endpoints, disponible sin clave.
Tu primera solicitud sale en cinco minutos.