Developers guide.

Stack technique

• Runtime · Vercel Edge Functions (Fluid Compute), régions Paris + Frankfurt
• Database · Supabase Postgres 15, project ykafzpuxicvgatdluuel, region eu-west-3
• LLM · Anthropic Claude Sonnet 4.6 (génération) + Haiku 4.5 (classification), zero retention
• Embeddings · Voyage AI voyage-3
• Email · Resend, branded tracking domain par workspace
• Auth · Supabase Auth (magic link + 2FA TOTP) · JWT signés, rotation 7j
• Pricing model · usage-based, coût upstream brut visible côté client

API REST publique

Base URL : https://www.orkelia.com/api. Auth via header Authorization: Bearer YOUR_API_KEY. Les clés sont générées dans le dashboard workspace (rotation supportée).

Workspaces

Drafts & envoi

Replies & classification

Conversations agent (Clinique/Restau/Transport)

Webhooks sortants

Configurer un endpoint dans le dashboard workspace. Orkelia POST en application/json avec signature HMAC SHA-256 dans le header X-Orkelia-Signature.

Événements supportés

// Liste exhaustive (v1)
draft.created      // Un nouveau draft a été généré
draft.approved     // Un draft a été validé
email.sent         // Un email a été envoyé
email.opened       // Open tracking Resend
email.clicked      // Click tracking Resend
reply.received     // Une réponse a été reçue
reply.classified   // Haiku a classifié l'intention
hot_lead.detected  // Escalade automatique
conversation.escalated// Agent a passé la main

Vérification signature (Node.js)

import crypto from 'node:crypto';

const sig = req.headers['x-orkelia-signature'];
const expected = crypto
  .createHmac('sha256', process.env.ORKELIA_WEBHOOK_SECRET)
  .update(JSON.stringify(req.body))
  .digest('hex');

if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
  return res.status(401).end();
}

MCP server (Model Context Protocol)

Orkelia expose un serveur MCP officiel à https://www.orkelia.com/api/mcp pour exposer ses tools à n'importe quel agent IA compatible MCP (Claude Code, Cursor, Cline, etc.).

Tools exposés (workspace-scoped)

get_workspace_config(workspace_id)
list_prospects(workspace_id, filters?)
get_prospect_history(prospect_id)
create_draft(workspace_id, prospect_id, template_key, variables)
approve_draft(draft_id)
get_reply_classification(reply_id)
escalate_to_human(conversation_id, reason)
add_to_suppression_list(email, reason)
get_kpis(workspace_id, date_range)

Configuration Claude Code

// ~/.claude/mcp.json
{
  "mcpServers": {
    "orkelia": {
      "transport": "http",
      "url": "https://www.orkelia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

SDK officiels (roadmap)

• Node.js / TypeScript · @orkelia/sdk · Q3 2026 · types complets, retry exponentiel, webhook helpers
• Python · orkelia sur PyPI · Q3 2026 · async support, Pydantic models
• OpenAPI 3.1 spec · Disponible à /api/openapi.json · génération clients custom (Go, Rust, Ruby)

D'ici les SDKs officiels, l'API REST est stable et documentée. Toute requête échoue gracieusement (erreurs HTTP standard + body JSON détaillé).

Rate limits

• Free / Trial · 60 req/min, 1 000 req/jour
• Essentiel · 300 req/min, 50 000 req/jour
• Pro · 1 000 req/min, 250 000 req/jour
• Groupe · Custom (négocié)

Headers de réponse : X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Retours 429 avec Retry-After.

Open source & templates

• n8n workflows · 5 templates Orkelia (intake CRM, escalade Slack, sync HubSpot) — sur demande
• Make scenarios · 4 scenarios prêts à l'emploi pour starts
• Zapier templates · workflows pré-câblés Pipedrive/HubSpot/Notion
• Postman collection · API REST complète importable

Sécurité & sandbox

L'environnement sandbox (sandbox.orkelia.com) est en cours d'ouverture (Q3 2026). En attendant, créez un workspace de test dans votre compte de production avec le flag is_test=true — les emails ne partent pas réellement, les hits Anthropic sont comptabilisés normalement.

Pour le disclosure responsable de vulnérabilités, écrivez à security@orkelia.com.