API Sendveo

L'API Sendveo permet à vos systèmes de connecter des numéros WhatsApp, d'envoyer et recevoir des messages, et de diffuser les messages entrants vers votre propre point de terminaison, le tout sous votre compte Sendveo. C'est une API REST petite et prévisible qui parle JSON via HTTPS.

Introduction

Chaque requête est authentifiée avec une clé API que vous créez dans le tableau de bord. Les réponses sont en JSON, les erreurs partagent une même enveloppe, et les identifiants sont des chaînes opaques que vous pouvez stocker telles quelles.

URL de base

Tous les points de terminaison résident sous une seule URL de base versionnée :

https://api.sendveo.com/v1

Les chemins de cette référence sont relatifs à cette base, par exemple /numbers correspond à https://api.sendveo.com/v1/numbers.

Démarrage rapide

Envoyez votre première requête. Listez les numéros de votre compte :

curl https://api.sendveo.com/v1/numbers \
  -H "X-API-KEY: sv_live_your_key_here"

Une réponse réussie :

{
  "numbers": [
    {
      "id": "chn_sales01",
      "displayName": "Sales line",
      "declaredNumber": "+212661234567",
      "pairedNumber": "+212661234567",
      "status": "CONNECTED",
      "connectedAt": "2026-08-19T09:12:00Z"
    }
  ]
}

Mises à jour en direct dans le tableau de bord

Le tableau de bord Sendveo se tient à jour tant qu'il est ouvert : les coches de livraison avancent, les réactions et les modifications apparaissent, les nouveaux messages arrivent dans la liste avec leurs compteurs de non-lus, et un numéro qui change d'état se voit immédiatement. Il lit un flux sur GET /app/events qui porte les mêmes seize événements que le webhook, dans les mêmes formes. Pour vos propres systèmes, le webhook est le canal à utiliser, car il est durable et réessayable ; le flux est fait pour un navigateur qui tient une session de tableau de bord.

Conventions

Les numéros de téléphone utilisent le format E.164 (un + initial suivi de l'indicatif du pays). Les horodatages sont au format ISO 8601 en UTC. Les identifiants sont des chaînes opaques ; les compteurs sont des nombres. Tous les points de terminaison de liste renvoient un objet avec un tableau nommé, jamais un tableau brut.

La facturation est en lecture seule via l'API : le point de terminaison de facturation renvoie vos emplacements (par carte et par crédit, autorisés et utilisés) et le crédit disponible sur votre compte. Pour acheter par carte, activer des numéros avec votre crédit ou consulter votre historique de débits et de crédits, utilisez la page Facturation du tableau de bord.