Desarrolladores

Una API de entrada. Un webhook de salida.

Yesly se sitúa entre tu sistema y tu cliente. Tú creas la cita; nosotros conseguimos la respuesta y te la devolvemos. Sin plantillas que aprobar, sin operadores que contratar, sin telefonía que operar.

Ver la referencia de la API Pedir acceso al sandbox

REST + JSON
SDK en 5 lenguajes
Webhooks firmados
Sandbox con números de prueba
Importación por CSV

Integración

Tres pasos. Dos son nuestros.

01
Crea la cita
Un POST con el cliente, la franja y, si quieres, metadatos propios como el número de pedido. Una a una según las programa tu sistema, o en bloque cada mañana.
POST /v1/appointments
02
Nosotros recorremos los canales
Primero WhatsApp, SMS si no responde, una llamada si sigue sin responder. Plantillas, números y operadores son cosa nuestra. Tú no haces nada.
whatsapp → sms → voice
03
Recibe la respuesta
Un webhook firmado con confirmada, cambiada o cancelada, el canal que la consiguió, la nueva franja si la hay y tus metadatos tal cual los enviaste.
appointment.confirmed

Tiempo hasta la primera confirmación: Minutos tras tu primer POST
Integración típica: Un desarrollador, de dos a cinco días
Idempotencia: Por external_id, reintentos seguros
Reintentos de webhook: Backoff exponencial durante 24 h

Escalado

El flujo completo, paso a paso.

Tu sistema

Crea la cita

Se envía el día antes de la cita

Sin respuesta en 2 h

SMS

Llega a cualquier móvil, sin datos

Sin respuesta en 2 h

Llamada de voz

Voz natural, solo si nada más funcionó

Sin respuesta · marcada para tu equipo

Responde

Respondió

Confirmada

Webhook a tu sistema

Tu sistema

Nos envía la cita por API

Se envía el día antes de la cita

Responde → confirmada

Sin respuesta en 2 h

SMS

Llega a cualquier móvil, sin datos

Responde → confirmada

Sin respuesta en 2 h

Llamada de voz

Voz natural, solo si nada más funcionó

Respondió → confirmada

Sin respuesta · marcada para tu equipo

Confirmada

O cambiada, o cancelada. Webhook a tu sistema.

Integración

Una API y webhooks. En producción en días.

Creas la cita con una llamada. Recibes la respuesta con otra. Sin plantillas que aprobar ni operadores que contratar.

REST con JSON y claves de API
SDK para Node.js, Python, PHP, Java y .NET
Webhooks firmados
Entorno de pruebas
Importación por CSV si aún no tienes API

Ver la referencia de la API

1 · Crea la cita

curl -X POST https://api.yesly.io/v1/appointments \
  -H "Authorization: Bearer ysk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "ORD-48213",
    "type": "delivery",
    "customer": { "name": "Martha", "phone": "+34612345678" },
    "slot": { "start": "2026-11-13T09:00:00+01:00", "end": "2026-11-13T11:00:00+01:00" },
    "metadata": { "order_id": "PV-18342", "route_id": "BIO-07" }
  }'

$ npm install @yesly/node

import Yesly from "@yesly/node";

const yesly = new Yesly(process.env.YESLY_API_KEY);

await yesly.appointments.create({
  external_id: "ORD-48213",
  type: "delivery",
  customer: { name: "Martha", phone: "+34612345678" },
  slot: { start: "2026-11-13T09:00:00+01:00", end: "2026-11-13T11:00:00+01:00" },
  metadata: { order_id: "PV-18342", route_id: "BIO-07" },
});

$ pip install yesly

import os
from yesly import Yesly

yesly = Yesly(api_key=os.environ["YESLY_API_KEY"])

yesly.appointments.create(
    external_id="ORD-48213",
    type="delivery",
    customer={"name": "Martha", "phone": "+34612345678"},
    slot={"start": "2026-11-13T09:00:00+01:00", "end": "2026-11-13T11:00:00+01:00"},
    metadata={"order_id": "PV-18342", "route_id": "BIO-07"},
)

$ composer require yesly/yesly-php

$yesly = new \Yesly\Client(getenv('YESLY_API_KEY'));

$yesly->appointments->create([
    'external_id' => 'ORD-48213',
    'type' => 'delivery',
    'customer' => ['name' => 'Martha', 'phone' => '+34612345678'],
    'slot' => ['start' => '2026-11-13T09:00:00+01:00', 'end' => '2026-11-13T11:00:00+01:00'],
    'metadata' => ['order_id' => 'PV-18342', 'route_id' => 'BIO-07'],
]);

implementation("io.yesly:yesly-java:1.+")

Yesly yesly = new Yesly(System.getenv("YESLY_API_KEY"));

yesly.appointments().create(AppointmentCreateParams.builder()
    .externalId("ORD-48213")
    .type("delivery")
    .customer("Martha", "+34612345678")
    .slot("2026-11-13T09:00:00+01:00", "2026-11-13T11:00:00+01:00")
    .putMetadata("order_id", "PV-18342")
    .putMetadata("route_id", "BIO-07")
    .build());

$ dotnet add package Yesly

var yesly = new YeslyClient(Environment.GetEnvironmentVariable("YESLY_API_KEY"));

await yesly.Appointments.CreateAsync(new AppointmentCreateOptions
{
    ExternalId = "ORD-48213",
    Type = "delivery",
    Customer = new() { Name = "Martha", Phone = "+34612345678" },
    Slot = new() { Start = "2026-11-13T09:00:00+01:00", End = "2026-11-13T11:00:00+01:00" },
    Metadata = new() { ["order_id"] = "PV-18342", ["route_id"] = "BIO-07" },
});

2 · Recibe la respuesta por webhook 200

{
  "id": "evt_5Hq1Kd",
  "type": "appointment.confirmed",
  "data": {
    "appointment": {
      "external_id": "ORD-48213",
      "status": "confirmed",
      "answer": { "channel": "whatsapp", "at": "2026-11-12T10:04:12+01:00" },
      "metadata": { "order_id": "PV-18342", "route_id": "BIO-07" }
    }
  }
}

Confianza

Hablamos con tus clientes. Nos lo tomamos en serio.

Datos en la UE
Procesados y almacenados en centros de datos europeos.
RGPD, con contrato de encargo
Actuamos como encargado del tratamiento, con DPA para cada cliente.
Sobre AWS
Alta disponibilidad, copias automáticas, ISO 27001 y ENS.
Cifrado y webhooks firmados
TLS en todo, claves gestionadas y cada webhook firmado.
Nunca de noche
Nunca más de lo acordado. Tu cliente se da de baja con un mensaje.
Nada se pierde
Cada cita sin respuesta queda marcada para tu equipo.

Una API de entrada. Un webhook de salida.

Tres pasos. Dos son nuestros.

Crea la cita

Nosotros recorremos los canales

Recibe la respuesta

El flujo completo, paso a paso.

Una API y webhooks. En producción en días.

Hablamos con tus clientes. Nos lo tomamos en serio.

Datos en la UE

RGPD, con contrato de encargo

Sobre AWS

Cifrado y webhooks firmados

Nunca de noche

Nada se pierde