Claves de API, webhooks y Zapier
Conecta otras herramientas con claves de API y webhooks
En la edición Chain otro sistema puede trabajar con tu espacio: una clave de API para las peticiones hacia Setvos y webhooks para las novedades que salen de él. Todavía no hay una app en Zapier; la receta de abajo usa los pasos de webhook que Zapier y Make ya tienen.
Crea una clave
Abre Integraciones → API y webhooks y, en Claves de API, elige Nueva clave. Ponle el nombre del sistema que la usará y marca solo lo que necesita: una clave actúa en tu nombre y nunca puede más que tú. Cópiala enseguida: se muestra una sola vez y no se guarda.
Envía peticiones
Pon la clave en la cabecera Authorization como «Bearer stv_live_…» y envía las peticiones a la dirección de la API que aparece en la misma tarjeta. Una clave hace hasta 300 peticiones por minuto, y una lista de direcciones en la clave limita desde dónde se puede usar.
Sustituye la clave antes de que caduque
Una clave deja de funcionar un año después de emitirse. Sustitúyela en la tarjeta: la nueva conserva el nombre, el alcance y la lista de direcciones, y la antigua funciona hasta que la revoques, así puedes pasar primero el otro sistema a la nueva.
Suscríbete a eventos
En Webhooks elige Nuevo webhook, pega la dirección que recibirá los eventos y márcalos: un contacto añadido o modificado, un trato que cambia de etapa o se gana, una factura pagada, una cita reservada o cancelada, un pedido pagado. Cada entrega es un POST con el nombre del evento en X-Setvos-Event y una firma en X-Setvos-Signature: sha256= y el HMAC del cuerpo, hecho con el secreto de firma que se mostró al crear el webhook.
Monta un escenario en Zapier o Make
En Zapier empieza un Zap con Webhooks by Zapier → Catch Hook; en Make, un escenario con Webhooks → Custom webhook. Pega la dirección que te den en un nuevo webhook aquí, pulsa Enviar prueba y asigna los campos. Para actuar en Setvos desde un escenario, usa Webhooks by Zapier → Custom Request o el módulo HTTP de Make, con tu clave en la cabecera Authorization.
Preguntas frecuentes
- ¿Qué edición incluye claves de API?
- Chain. Un espacio que deja Chain conserva sus claves, pero dejan de funcionar ese mismo día.
- ¿Qué pasa si una entrega falla?
- Se vuelve a intentar: seis intentos en total a lo largo de casi un día. La tarjeta del webhook muestra las entregas recientes, y un webhook que falla veinte veces seguidas se pausa hasta que lo reanudes.
- ¿Hay una app de Setvos en el directorio de Zapier?
- Todavía no. Los pasos Catch Hook y Custom Request de arriba hacen lo mismo hoy.
Dónde está en el producto
Sigue leyendo
Espacio de trabajo y perfil: cómo está configurado tu negocio
Los ajustes que definen todo el espacio de trabajo —los datos del negocio, los módulos, los campos personalizados, la IA y el registro de auditoría— y tu propio perfil.
Contactos: tus clientes y las empresas en las que trabajan
Ten una ficha por cliente con su historial, sus notas, sus etiquetas y sus archivos, encuentra a cualquiera en segundos y mantén la lista libre de duplicados.
Facturas: cobra a tus clientes y controla quién te debe
Para qué sirven las pantallas de facturas, cómo pasa una factura de borrador a pagada y qué configurar antes de enviar la primera.
Saca tus reservas del papel, de WhatsApp y de tres hojas de cálculo.
Importa tus clientes, servicios y visitas pasadas desde una hoja de cálculo o desde la exportación de tu sistema anterior, con una vista previa antes de que se escriba nada, y pide ayuda por chat, en seis idiomas, cuando la necesites. La mayoría de los estudios están funcionando el mismo día.