L'API publique v1 permet d'automatiser la gestion de vos tickets depuis vos propres outils (CRM, ERP, scripts internes). Elle est authentifiee par cle API.

1. Creer une cle API

Parametres > Developpeurs > Cles API. La cle complete (prefixee octo_sk_) n'est affichee qu'une seule fois. Scopes disponibles : read, write, chat (write implique read).

2. Authentification

Toutes les requetes utilisent l'en-tete suivant :

Authorization: Bearer octo_sk_XXXXXXXXXXXXXXXXXXXX

3. Endpoints

GET  /api/v1/me                Identite, plan, espace entreprise
GET  /api/v1/tickets           Liste (status, priority, limit, cursor)
POST /api/v1/tickets           Creer un ticket (scope write)
GET  /api/v1/tickets/:id       Detail + commentaires
GET  /api/v1/openapi           Specification OpenAPI 3.0

Spec complete et importable dans Postman/Insomnia : GET /api/v1/openapi

4. Webhooks signes

Chaque livraison POST inclut un en-tete X-Octobot-Signature: t=<secondes>,v1=<hmac> ou hmac = HMAC-SHA256(secret, "<timestamp>.<corps brut>"). Verifiez-le avant de faire confiance a un payload.

import hmac, hashlib
expected = "t=%s,v1=%s" % (t, hmac.new(secret, f"{t}.{body}".encode(), hashlib.sha256).hexdigest())

Evenements : ticket.created, ticket.updated, ticket.commented, conversation.handoff_requested, conversation.negative_sentiment, csat.received, booking.confirmed.