Developer Platform

Intégrez Famulor AI dans votre produit

API REST pour les appels, WhatsApp, SMS et messagerie, plus serveur MCP, webhooks temps réel et tableau de bord. La communication IA dans n’importe quel produit, en quelques minutes.

Lire la documentationCommencer
calls.create.ts
POST /v1/calls
{
  "assistant_id": "front-desk",
  "to": "+1555010148"
}

→ 202 Accepted
{ "call_id": "call_9f2ac1" }
call.completed
Webhook delivered
MCP server online

0

canaux d'API

0

langues

3.1

spécification OpenAPI

Gratuit

pour commencer

API Explorer

Une plateforme, tous les canaux

Une API HTTP, des webhooks et MCP: appels, assistants, WhatsApp Business, SMS, numéros et SIP, campagnes et leads.

  • Appels & campagnes: cycle de vie sortant/entrant, statuts, intégrations
  • Assistants & bases de connaissances: prompts, voix, modèles, documents
  • Conversations & réponses IA: sessions de chat, messagerie, transfert à un humain
  • WhatsApp Business: expéditeurs, modèles, sessions dans la fenêtre de 24h
  • SMS: envois programmatiques depuis vos numéros Famulor
  • Webhooks: payloads signés de fin d'appel et de fin de conversation
  • Serveur MCP & Famulor Skill: connectez des hôtes IA compatibles MCP
Shell · Quick start (cURL)
curl --request GET \
  --url https://app.famulor.io/api/user/calls \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
JavaScript · Voice API
// List your AI calls (User API)
const res = await fetch('https://app.famulor.io/api/v1/calls', {
  headers: {
    Authorization: 'Bearer YOUR_API_TOKEN',
    Accept: 'application/json',
  },
})
const payload = await res.json()
Ce que vous pouvez construire

Intégrez-le dans n'importe quelle stack

D’un déclencheur d’appel sortant à l’API complète: Famulor s’adapte à votre produit.

API en marque blanche

Votre plateforme. Vos clients.

Créez votre portail client. Ouvrez des comptes, gérez les accès et transférez des crédits par API. Votre domaine utilise les mêmes chemins API.

Lire la documentation
POST /api/v1/platform/users
curl https://your-domain.example/api/v1/platform/users \
  --request POST \
  --header "Authorization: Bearer $FAMULOR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Alex Example",
    "email": "alex@customer.example",
    "mode": "invite"
  }'

Créer des comptes clients

Inscrivez vos clients avec leur workspace et consultez la synthèse de leur compte.

GET · POST /platform/usersGET /platform/users/{user_id}

Gérer les accès

Émettez des tokens, connectez un parcours de connexion et révoquez les accès au besoin.

POST /platform/users/{user_id}/tokenPOST /platform/users/loginPOST /platform/users/{user_id}/logout

Transférer des crédits

Déplacez des crédits entre votre solde revendeur et les comptes clients.

POST /platform/users/{user_id}/balance

Configurer les inscriptions

Pilotez les inscriptions, les valeurs prépayées et les crédits de bienvenue depuis votre logiciel.

GET · PATCH /platform/default-limitsGET · PATCH /platform/welcome-credits

Connecter votre domaine

Ajoutez votre domaine, obtenez les entrées DNS et vérifiez son activation par API.

GET · POST · DELETE /custom-domainPOST /custom-domain/verify

Gérer avec MCP

Connectez les outils de gestion des clients et des crédits à votre client IA.

/mcp?toolsets=platform

Pour les revendeurs avec API Access et un rôle Owner ou Admin. La gestion des clients utilise platform:read / platform:write ; les domaines, les scopes de paramètres adaptés.

Webhooks

Réagissez à chaque appel, en temps réel

Des événements webhook signés vers votre endpoint à chaque étape de l’appel. Pas de polling: votre backend sait tout de suite si un lead est qualifié ou un rendez-vous confirmé.

call.started

Déclenché à la connexion de l'appel

call.variable_extracted

L'IA a capturé une donnée clé

call.completed

Appel terminé: résultat et transcription prêts

appointment.created

Rendez-vous confirmé dans votre calendrier

webhook.payload.json
{
  "event": "call.completed",
  "call_id": "call_9f2ac1",
  "assistant": "front-desk",
  "outcome": "appointment_booked",
  "duration_seconds": 96
}
Intégration MCP

Donnez à votre agent IA une vraie ligne

Un serveur MCP (Model Context Protocol) pour Claude et d’autres hôtes. Vos agents passent des appels, envoient WhatsApp et gèrent des leads.

transport stdio
transport SSE
auth OAuth 2.0
schéma d'outils complet
Documentation du serveur MCPDocumentation Famulor Skill
JavaScript · Claude + Famulor MCP
// Connect Famulor as an MCP server
const client = new Anthropic();

const response = await client.messages.create({
  model: 'claude-opus-4-6',
  max_tokens: 1024,
  tools: [{
    type: 'mcp',
    server_label: 'famulor',
    server_url:   'https://app.famulor.io/mcp',
    headers:      { Authorization: 'Bearer YOUR_API_TOKEN' },
  }],
});

Compatible avec

Claude (Anthropic)CursorWindsurfClaude Code
Authentification

Sécurisé par défaut

Chaque requête API passe par un jeton Bearer à portée limitée. Les webhooks sont signés en HMAC-SHA256: vous vérifiez l’authenticité avant traitement.

  • Authentification par jeton Bearer: par équipe, révocable
  • Vérification de signature HMAC-SHA256 sur les webhooks
  • Chiffrement TLS sur tous les endpoints
  • Liste blanche d'IP disponible sur les offres entreprise
Gérer les clés API
Shell + Python · Auth examples
# Bearer token
curl --request GET \
  --url https://app.famulor.io/api/user/calls \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

# Verify a webhook signature
import hmac, hashlib

def verify_signature(payload: bytes, sig: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)
Ressources

Aller plus loin dans la documentation

Prêt à construire ?

Créez un compte gratuit et obtenez votre clé API en quelques minutes.

Essayer gratuitementRéserver une démo