Skip to main content
Les Webhooks vous permettent d’être notifié en temps réel lorsque des événements se produisent sur votre compte Xalantis (ex: création d’un ticket, mise à jour d’un statut, etc.).

​
Configuration

Vous pouvez configurer votre URL de Webhook dans les Paramètres > Clés API de votre tableau de bord. Une seule URL est supportée par clé API.

​
Format des Payloads

Chaque notification Webhook est envoyée via une requête POST avec un corps JSON contenant :
  • event : Le nom de l’événement.
  • created_at : La date de l’événement.
  • data : Les données associées (Ticket, Deal, etc.).
{
    "event": "ticket.created",
    "created_at": "2024-01-01T12:00:00Z",
    "data": {
        "uuid": "...",
        "subject": "Problème de connexion",
        "status": "open"
        // ... objet complet
    }
}

​
Vérification de Signature

Pour des raisons de sécurité, nous signons chaque requête Webhook afin que vous puissiez vérifier qu’elle provient bien de Xalantis. Le header X-Webhook-Signature contient une signature HMAC SHA-256 du corps de la requête, signée avec votre Clé Secrète.

​
Exemple de vérification (PHP)

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'];
$secret = 'votre_cle_secrete';

$computedSignature = hash_hmac('sha256', $payload, $secret);

if (hash_equals($computedSignature, $signature)) {
    // Requête valide
} else {
    // Requête invalide
}

​
Événements Disponibles

​
Tickets

ÉvénementDescription
ticket.createdUn nouveau ticket a été créé.
ticket.updatedUn ticket existant a été mis à jour (statut, priorité, etc.).

​
CRM

ÉvénementDescription
deal.createdUne nouvelle opportunité a été créée.
deal.updatedUne opportunité a été mise à jour (changement d’étape, etc.).
deal.wonUne opportunité a été gagnée.
deal.lostUne opportunité a été perdue.