Introduction

L'API WiseParts connecte des systèmes externes à votre compte via HTTP. Un seul jeton d'intégration authentifie toutes les requêtes, l'URL de base et les conventions décrites ci-dessous s'appliquent partout, et chaque domaine du produit expose ses propres points de terminaison.

La voix est le domaine disponible aujourd'hui. Vous envoyez les événements d'appel au fur et à mesure qu'ils se produisent — sonnerie, appel répondu, appel terminé — et WiseParts les transforme en appels. Chaque appel alimente ensuite trois choses : la barre de notification à l'écran, l'activité enregistrée automatiquement et les chiffres des Rapports d'appels. Consultez Centre d'appels pour savoir ce que le produit en fait.

URL de base

https://app.wiseparts.ai/api/v1

La version est un segment du chemin, et non un en-tête ou un paramètre de requête. Tous les chemins de la référence sont relatifs à cette base, quel que soit le domaine auquel ils appartiennent, et la production est le seul serveur.

Opérations vocales

Post a call event — POST /voice/call. Crée un appel, ou fait avancer un appel qui existe déjà. Envoyez une requête par changement d'état, en réutilisant le même id pendant tout l'appel.

Look up a caller's priority — GET /voice/priority. À partir d'un numéro, renvoie la priorité du segment auquel appartient le client correspondant, afin que votre plan de routage puisse placer les clients connus en tête de file avant que l'appel ne soit présenté.

List request history — GET /voice. Renvoie ce que WiseParts a enregistré pour votre compte : la charge utile telle qu'elle a été reçue, la réponse, le statut et la durée.

Les deux premières répondent aussi sur l'autre verbe — /voice/call accepte GET avec les mêmes champs dans la chaîne de requête, /voice/priority accepte POST — pour les systèmes téléphoniques qui savent seulement appeler une URL.

Votre premier appel

Les étapes ci-dessous utilisent les points de terminaison vocaux, mais le jeton et les conventions restent les mêmes quel que soit le domaine que vous appellerez.

1. Récupérez le jeton. Accédez à Intégrations, ouvrez l'intégration que vous connectez et copiez son jeton. Il identifie à la fois le compte et l'intégration, il n'y a donc pas d'identifiant de compte séparé. Consultez Authentification pour les différentes façons de l'envoyer.

2. Envoyez un événement.

curl -X POST https://app.wiseparts.ai/api/v1/voice/call \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "CALL-2026-08-12-0042",
    "direction": "inbound",
    "status": "answered",
    "from": "+351210000000",
    "caller_id": "201"
  }'

id, direction et status sont obligatoires, et from l'est lorsque la direction est inbound. La réponse contient une chaîne result de 48 caractères aléatoires qui n'identifie rien — c'est votre propre id qui reste la référence à conserver.

3. Retrouvez-le dans l'historique.

curl "https://app.wiseparts.ai/api/v1/voice?search=request&search_term=CALL-2026-08-12-0042&sort=-created_at&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

search et search_term ne fonctionnent qu'ensemble, et il n'existe aucun tri par défaut : passez donc sort lorsque l'ordre compte. Envoyez également Accept: application/json : sans cet en-tête, une requête dont l'authentification échoue répond par un 302 vers une page de navigateur plutôt que par un 401.

Un 200 à l'étape 2 confirme la réception, pas qu'un appel a été enregistré : un appel ne progresse que vers l'avant, et un événement qui arrive dans le désordre est accepté puis ignoré. Post a call event liste les statuts et indique lesquels peuvent en écraser d'autres.

Si l'appel n'apparaît jamais, Dépannage explique où chercher — à commencer par le fait qu'une requête dont l'authentification échoue ne laisse aucune entrée.