Conecta la API de tu propio sistema

Cómo funciona

• En Herramientas, pulsa Nueva herramienta y elige API de tu sistema. Cada herramienta es una petición, como ver horarios libres o reservar una clase: añade una para cada una.
• Pega la parte de la documentación de tu API de esa petición, un ejemplo en cURL o descríbela con palabras, y pulsa Hacer el cURL.
• Digui escribe la petición como un cURL, con {{marcadores}} para lo que cambia en cada llamada. Al lado ves la petición que entendió Digui: qué envía, adónde y quién completa cada valor.
• Escribe la clave de tu API (o un usuario y una contraseña), o usa la que guardaste en otro conector de API para la misma dirección. Se guarda cifrada y no se vuelve a mostrar.
• Pulsa Probar, luego Guardar y conectar, y dásela a tus recepcionistas.

Un ejemplo: reservar una clase en Sunrise Yoga

Sunrise Yoga es un estudio inventado. La documentación de su API para reservar una clase dice:

POST https://api.sunriseyoga.example/v1/bookings
Books a class for a member.
Headers: Authorization: Bearer <your API key>, Api-Version: 2
Body (JSON):
  class_id    integer   The class
  start       string    When, as YYYY-MM-DDTHH:MM
  member_id   integer   The member, or
  phone       string    the member's phone number
  notes       string    Optional

El cURL que hace Digui

Con eso, Digui escribe este cURL. Puedes editarlo: lo que ves es lo que se envía. {{key}} es donde va tu clave, así que el cURL nunca la lleva. Api-Version: 2 es un valor fijo, que se envía tal cual en cada llamada.

curl -X POST 'https://api.sunriseyoga.example/v1/bookings' \
  -H 'Authorization: Bearer {{key}}' \
  -H 'Api-Version: 2' \
  -H 'Content-Type: application/json' \
  --data-raw '{"class_id": {{class_id}}, "start": "{{start}}", "member_id": {{member_id}}, "phone": "{{phone}}", "notes": "{{notes}}"}'

Quién completa cada valor

Quién es la persona nunca sale de lo que dice. En una llamada, es el número desde el que llama. En el chat de tu web, es el id de socio que firma tu web. Si no está ninguno, la recepcionista dice que eso no se puede hacer aquí. En JSON, el texto va entre comillas ("{{start}}"), y los números y sí/no van sin ellas ({{class_id}}).

Prueba, y luego guarda

Probar envía de verdad una petición que solo lee, con los valores de ejemplo que escribas. Una reserva cambia algo, así que Probar primero muestra la petición que enviaría, con tu clave como ********, y solo la envía cuando pulsas Enviarlo de verdad. Guardar la conecta: tus recepcionistas tienen una herramienta que envía exactamente esa petición, y le preguntan a la persona antes de reservar.

Qué envía Digui, y qué no

• Solo a la dirección del cURL, por https, y solo si es una dirección pública. Un valor de una llamada nunca cambia adónde va una petición.
• Una clave, un usuario y una contraseña, o nada. Nunca un inicio de sesión con Google u otra cuenta: para eso, usa la herramienta de esa app.
• Cuerpos JSON o de formulario. Sin archivos, cookies, proxies ni -k.
• Espera 10 segundos como mucho, nunca sigue redirecciones y pasa los primeros 20 KB de una respuesta.
• Tu clave guardada nunca llega a la IA, a los registros ni al panel: dondequiera que pudiera aparecer, es ********. Pega la documentación con algo como YOUR_API_KEY en lugar de tu clave real (si pegas una igual, Digui la saca del cURL y la guarda oculta).