Como conectar o Almendra a outras ferramentas (API e webhooks)

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. 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.