Intégrez le conseiller Parlyo dans votre app

1. Modèle d'authentification

Votre clé publique (pk_live_…, visible dans le dashboard → Installation) identifie votre compte. Elle n'est pas un secret : chaque appel est validé par l'origine de la requête, qui doit figurer dans vos domaines autorisés (dashboard → Installation → Domaines).

• Web : le navigateur envoie l'en-tête Origin automatiquement.
• App mobile / desktop (pas d'Origin) : envoyez X-Parlyo-App: com.votreapp.ios et ajoutez com.votreapp.ios à vos domaines autorisés. Un identifiant non déclaré est refusé (403).

2. Endpoints

Format de history

[{ "role": "user", "text": "Bonjour" }, { "role": "model", "text": "Bonjour ! Comment puis-je aider ?" }]

3. Démarrage rapide

curl

# 1. Config + JWT (app mobile : X-Parlyo-App au lieu d'un Origin)
curl "https://parlyo.io/api/embed/config?pk=pk_live_VOTRE_CLE&lang=fr" \
  -H "X-Parlyo-App: com.votreapp.ios"

# 2. Chat
curl -X POST "https://parlyo.io/api/embed/chat" \
  -H "X-Parlyo-App: com.votreapp.ios" \
  -H "Authorization: Bearer LE_JWT" \
  -H "Content-Type: application/json" \
  -d '{"message":"Quels sont vos horaires ?","history":[]}'

JavaScript (web ou React Native)

const BASE = "https://parlyo.io/api/embed";
const PK = "pk_live_VOTRE_CLE";
const APP = "com.votreapp.ios";          // apps natives uniquement

let jwt = null;
async function session() {
  const r = await fetch(`${BASE}/config?pk=${PK}&lang=fr`, { headers: { "X-Parlyo-App": APP } });
  const j = await r.json(); jwt = j.jwt; return j;   // j.greeting, j.suggestions…
}
async function ask(message, history = []) {
  if (!jwt) await session();
  let r = await fetch(`${BASE}/chat`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "Authorization": `Bearer ${jwt}`, "X-Parlyo-App": APP },
    body: JSON.stringify({ message, history }),
  });
  if (r.status === 401) { await session(); return ask(message, history); }  // JWT expiré → 1 retry
  return (await r.json()).replyText;
}

Swift (iOS)

var request = URLRequest(url: URL(string: "https://parlyo.io/api/embed/chat")!)
request.httpMethod = "POST"
request.setValue("com.votreapp.ios", forHTTPHeaderField: "X-Parlyo-App")
request.setValue("Bearer \(jwt)", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(["message": text, "history": []])
let (data, _) = try await URLSession.shared.data(for: request)

Kotlin (Android)

val body = JSONObject(mapOf("message" to text, "history" to JSONArray()))
val req = Request.Builder()
  .url("https://parlyo.io/api/embed/chat")
  .header("X-Parlyo-App", "com.votreapp.android")
  .header("Authorization", "Bearer $jwt")
  .post(body.toString().toRequestBody("application/json".toMediaType()))
  .build()

4. Connaissances & documents (RAG)

Le conseiller répond à partir de votre base de connaissances (dashboard → Connaissances — remplissable en un clic avec « Importer depuis mon site ») et de vos documents (PDF, TXT, Markdown, CSV) qu'il consulte automatiquement pendant la conversation. Aucun paramètre API supplémentaire : uploadez vos documents dans le dashboard, ils sont immédiatement consultables.

5. Limites & erreurs

6. Bonnes pratiques & sécurité

• La clé pk_ peut vivre dans le code client — la protection vient des domaines/bundle ids déclarés.
• Ne stockez jamais le JWT durablement (mémoire uniquement) ; il expire en 15 min par design.
• Vos quotas de plan s'appliquent à l'API comme au widget — un même cerveau, un même compteur.
• Feuille de route : clés serveur sk_ (backend-à-backend), streaming des réponses, webhooks de leads. Écrivez-nous : [email protected].