---
title: "Cómo conectar Almendra con otras herramientas (API y webhooks)"
description: "Crea una clave de API en Configuración > Desarrolladores > Claves API, elige sus permisos y, si quieres, agrega webhooks para que tu herramienta se entere de lo que pasa en Almendra."
sidebar:
  order: 25
lastModified: 2026-10-28
---

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](/help/otros/como-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.
