---
title: "Como conectar o Almendra a outras ferramentas (API e webhooks)"
description: "Crie uma chave de API em Configurações > Desenvolvedores > Chaves de API, escolha as permissões e, se quiser, adicione webhooks para sua ferramenta saber o que acontece no Almendra."
sidebar:
  order: 25
lastModified: 2026-10-28
translationKey: otros/como-conectar-almendra-con-otras-herramientas-api
---

Com a **API** do Almendra você conecta sua conta a outras ferramentas: o Zapier, um sistema feito para você ou outro assistente de IA. A API está disponível nos planos pagos.

Usa o ChatGPT ou o Claude? Você não precisa de uma chave: conecte direto com [Como usar o Almendra pelo ChatGPT e pelo Claude](/help/pt/outros/como-usar-o-almendra-no-chatgpt-e-no-claude). O assistente tem permissões próprias e não faz tudo o que uma chave de API faz: o que ele pode fazer está nesse artigo.

**O que uma ferramenta conectada pode fazer?**

- Ver, criar e editar **pacientes**.
- Ver, agendar, **remarcar** e excluir **consultas**. Ao remarcar, o evento do Google Agenda, a reunião do Zoom e o lembrete do paciente também mudam.
- Ver seus **planos de serviço**.
- Ver, criar, editar e **enviar planos alimentares** (por dia, flexíveis ou por substituições).
- Criar e editar seus **alimentos, receitas e grupos de substituição**, e busque um alimento quando precisar. A busca é limitada de propósito para proteger o banco de dados de alimentos do Almendra: mostra os 5 melhores resultados e permite 50 buscas por dia por conta.
- Ver os **dados clínicos**: histórico clínico, notas de consulta, medidas e exames, e fotos de progresso.

**Como crio uma chave de API?**

1. Vá em **Configurações › Desenvolvedores › Chaves de API**.
2. Clique em **Criar chave de API** e dê um nome (por exemplo, "Zapier").
3. Escolha as **permissões**: o que a chave pode ver ou alterar. Marque só o que a ferramenta precisa.
4. Copie a chave e cole na sua ferramenta. Por segurança, ela só aparece uma vez.

Você pode mudar as permissões de uma chave quando quiser em **Editar permissões**, sem criar outra.

**Dados clínicos são sensíveis.** Uma chave só lê históricos clínicos, notas, exames e fotos se você marcar a permissão **Dados clínicos**. Ative apenas para ferramentas em que você confia. As chaves criadas antes das permissões continuam funcionando como antes (pacientes, consultas e planos de serviço) e não veem dados clínicos.

**O que são webhooks?**

Um webhook avisa sua ferramenta quando algo acontece no Almendra, sem que ela precise ficar perguntando. Você pode receber avisos quando:

- você **envia um plano alimentar**,
- você **finaliza uma consulta** (com notas, medidas e exames),
- **um paciente preenche o formulário** antes da consulta.

Para adicionar um, em **Configurações › Desenvolvedores › Webhooks** clique em **Adicionar webhook**. Digite o endereço (deve começar com `https://`), escolha os eventos e salve. Com **Enviar teste** você confirma que sua ferramenta recebe o aviso.

O aviso só traz identificadores, nunca dados de saúde: sua ferramenta consulta os detalhes com a chave de API e as permissões dela. Cada aviso chega assinado; o **Segredo** de cada webhook serve para confirmar que vem do Almendra.

**Onde está a documentação técnica?**

Em **Configurações › Desenvolvedores › Chaves de API**, o botão **Ver Documentação** abre a referência completa da API, com cada operação, a permissão que ela precisa e como verificar os webhooks.
