Cómo conectar Almendra con otras herramientas (API y webhooks)

Con la API de Almendra puedes conectar tu cuenta con otras herramientas: Zapier, un sistema hecho a tu medida u otro asistente de IA. La API está disponible en los planes de pago.

¿Usas ChatGPT o Claude? No necesitas una clave: conéctalos directamente siguiendo Cómo usar Almendra desde ChatGPT y Claude. El asistente tiene sus propios permisos y no hace todo lo que hace una clave de API: lo que puede hacer está en ese artículo.

¿Qué puede hacer una herramienta conectada?

• Ver, crear y editar pacientes.
• Ver, agendar, reprogramar y eliminar citas. Al reprogramar se mueven también el evento de Google Calendar, la reunión de Zoom y el recordatorio del paciente.
• Ver tus planes de servicio.
• Ver, crear, editar y enviar planes alimenticios (por día, flexibles o por intercambios).
• Crear y editar tus alimentos, recetas y grupos de intercambio, y buscar un alimento cuando lo necesitas. La búsqueda es limitada a propósito para proteger la base de datos de alimentos de Almendra: muestra los 5 mejores resultados y permite 50 búsquedas al día por cuenta.
• Ver los datos clínicos: historia clínica, notas de consulta, medidas y analíticas, y fotos de progreso.

¿Cómo creo una clave de API?

1. Ve a Configuración › Desarrolladores › Claves API.
2. Haz clic en Crear clave API y ponle un nombre (por ejemplo, “Zapier”).
3. Elige los permisos: qué puede ver o cambiar esa clave. Marca solo lo que la herramienta necesita.
4. Copia la clave y pégala en tu herramienta. Por seguridad, solo se muestra una vez.

Puedes cambiar los permisos de una clave cuando quieras con Editar permisos, sin crear una nueva.

Los datos clínicos son sensibles. Una clave solo puede leer historias clínicas, notas, analíticas y fotos si marcas el permiso Datos clínicos. Actívalo solo para herramientas en las que confías. Las claves que creaste antes de que existieran los permisos siguen funcionando como antes (pacientes, citas y planes de servicio) y no pueden ver datos clínicos.

¿Qué son los webhooks?

Un webhook avisa a tu herramienta cuando pasa algo en Almendra, sin que tenga que estar preguntando. Puedes recibir avisos cuando:

• envías un plan alimenticio,
• terminas una consulta (con sus notas, medidas y analíticas),
• un paciente completa su formulario antes de la consulta.

Para agregar uno, en Configuración › Desarrolladores › Webhooks haz clic en Agregar webhook. Escribe la dirección (debe empezar con https://), elige los eventos y guarda. Con Enviar prueba verificas que tu herramienta lo recibe.

El aviso solo incluye identificadores, nunca datos de salud: tu herramienta consulta los detalles con su clave de API y sus permisos. Cada aviso llega firmado; el Secreto de cada webhook sirve para comprobar que viene de Almendra.

¿Dónde está la documentación técnica?

En Configuración › Desarrolladores › Claves API, el botón Ver Documentación abre la referencia completa de la API, con cada operación, el permiso que necesita y cómo verificar los webhooks.