Une adresse dédiée reprend le format de l’API Twilio : un code écrit pour les bibliothèques Twilio (Node.js, PHP, Python…) fonctionne ici en changeant les identifiants et en ajoutant quelques lignes. Tout ce qui est disponible ici l’est aussi dans l’API habituelle.
#Identifiants
POST /api/org/twilio-compat/token (ou panneau › Intégrations › Compatibilité Twilio) crée l’Account SID (AC…) et l’Auth Token, affiché une seule fois ; un nouvel appel remplace le jeton. Authentification Basic AccountSid:AuthToken, comme chez Twilio.
#Adresses
| Twilio |
Ici |
https://api.twilio.com/2010-04-01/… |
/api/twilio/2010-04-01/… |
https://verify.twilio.com/v2/… |
/api/twilio/verify/v2/… |
https://lookups.twilio.com/v2/… |
/api/twilio/lookups/v2/… |
#Avec les bibliothèques Twilio
import twilio from 'twilio';
import { TwilioCompatHttpClient } from '@voxnova/sdk';
const client = twilio(ACCOUNT_SID, AUTH_TOKEN, { httpClient: new TwilioCompatHttpClient('https://api.exemple.fr') });
await client.messages.create({ to: '+33612345678', from: 'MaMarque', body: 'Bonjour' });
$client = new Twilio\Rest\Client(ACCOUNT_SID, AUTH_TOKEN, null, null, new VoxNova\Twilio\HttpClient('https://api.exemple.fr'));
$client->messages->create('+33612345678', ['from' => 'MaMarque', 'body' => 'Bonjour']);
from twilio.rest import Client
from twilio.http.http_client import TwilioHttpClient
class VoxNova(TwilioHttpClient):
def request(self, method, url, **kw):
host, path = url.split('://', 1)[1].split('/', 1)
prefix = {'api': '', 'verify': '/verify', 'lookups': '/lookups'}[host.split('.')[0]]
return super().request(method, 'https://api.exemple.fr/api/twilio' + prefix + '/' + path, **kw)
client = Client(ACCOUNT_SID, AUTH_TOKEN, http_client=VoxNova())
#Pris en charge
| Ressource |
Opérations |
Équivalent dans l’API habituelle |
| Messages |
créer (To, From, Body, StatusCallback), lire, lister |
POST /api/v1/sms (statusCallback) |
| Calls |
créer (To, From, Url ou Twiml, StatusCallback, Timeout), lire, lister, raccrocher (Status=completed), rediriger (Url, Twiml) |
POST /api/v1/calls (url, twiml, statusCallback), hangup, redirect |
| IncomingPhoneNumbers |
lister, lire, modifier (VoiceUrl, VoiceFallbackUrl, StatusCallback, FriendlyName) |
PATCH /api/v1/numbers/{number} |
| Recordings |
lister, lire, télécharger, supprimer |
/api/v1/recordings |
| Verify v2 |
Services, Verifications (sms, whatsapp), VerificationCheck, annulation |
/api/v1/verify |
| Lookups v2 |
PhoneNumbers (line_type_intelligence) |
GET /api/v1/lookup/{number} |
TwiML (réponse de votre adresse vocale) : Say, Play, Pause, Gather (Say/Play imbriqués), Dial (numéro, Number, Client, Sip, Conference, Queue), Record, Redirect, Hangup, Reject, Enqueue, Message. Les requêtes vers votre adresse sont au format Twilio (CallSid, From, To, CallStatus, Digits, RecordingUrl…) et signées X-Twilio-Signature avec votre Auth Token : la fonction de vérification des bibliothèques Twilio fonctionne telle quelle. Les applications de l’API habituelle acceptent aussi le TwiML (format: "twiml", ou réponse XML).
#Limites
Les codes d’erreur suivent ceux de Twilio (20003 authentification, 20404 introuvable, 21211 numéro invalide, 60200 et 60203 pour Verify…). Non pris en charge : MMS, Messaging Services, Conversations, Studio, Flex, TaskRouter, Video, et les SDK téléphone de Twilio (Voice SDK pour navigateur et mobiles) : utilisez le webphone. Lookups n’indique pas l’opérateur (carrier_name: null), peu fiable avec la portabilité.