Déployer

Votre propre trunk SIP

Gardez votre opérateur et vos numéros. Tout fournisseur qui envoie du SIP vers une URI avec authentification digest fonctionne avec CallShift.

Enregistrer un numéro sur un nouveau trunk

POST/v1/phones/sip connecte le trunk et enregistre le numéro en une seule requête.

JSON

{
  "phoneNumber": "+33187654321",
  "name": "acme-sip",
  "terminationUri": "sip.example.com",
  "transport": 1,
  "sipUsername": "acme",
  "sipPassword": "your-sip-password",
  "requireInboundAuth": true,
  "agentId": "550e8400-e29b-41d4-a716-446655440000"
}

Champ	Signification
`terminationUri`	L'adresse où CallShift envoie vos appels sortants
`transport`	`1` UDP, `2` TCP, `3` TLS
`sipUsername`, `sipPassword`	Les identifiants qu'attend votre opérateur
`requireInboundAuth`	Génère des identifiants que votre opérateur doit envoyer sur les appels entrants (désactivé par défaut)
`sipTrunkId`	Ajoute le numéro à un trunk existant au lieu d'en créer un ; les champs du trunk sont alors ignorés

Router les appels entrants

Chaque trunk dispose de sa propre connexion entrante authentifiée. Son URI d'origination et ses identifiants, à configurer chez votre opérateur, se trouvent dans la section Connection details du trunk, sur app.callshift.ai/phone-numbers. Attribuez ensuite l'agent au numéro.

Appels par seconde

La limite d'appels par seconde (callsPerSecond) est définie au niveau du trunk : elle est partagée par tous ses numéros, et par toutes les campagnes qui appellent depuis ces numéros. GET/v1/trunks permet de la consulter ; vous la modifiez dans le tableau de bord. C'est généralement elle qui fixe le rythme d'une campagne, plus que le nombre de lignes : le simulateur de campagne d'appels sortants calcule la durée de la vôtre.

Votre opérateur

Un opérateur est compatible avec CallShift s'il envoie les appels d'un numéro vers une URI SIP ; s'il ne les remet qu'à un équipement enregistré sur la ligne, il ne l'est pas. Les sections ci-dessous indiquent, opérateur par opérateur, ce qu'il faut reporter d'un côté à l'autre.

Twilio Elastic SIP Trunking

Les numéros d'un compte Twilio n'ont pas besoin de trunk : il est plus simple de les importer, voir Numéros de téléphone. Le trunk sert aux numéros que Twilio achemine par Elastic SIP Trunking. Dans la console Twilio, Elastic SIP Trunking › Trunks, créez un trunk, puis (guide Twilio) :

Termination. Choisissez la Termination SIP URI du trunk, nom.pstn.twilio.com, et, sous Authentication, créez une liste d'identifiants (credential list) avec un nom d'utilisateur et un mot de passe. Pour que les appels restent en Europe, passez par le point de présence de Dublin ou de Francfort : nom.pstn.dublin.twilio.com ou nom.pstn.frankfurt.twilio.com.
Numéros. Rattachez le numéro Twilio au trunk.
CallShift. Enregistrez le numéro sur un nouveau trunk (plus haut), avec les valeurs du tableau ci-dessous.
Origination. De retour dans Twilio, ajoutez une Origination SIP URI : sip: suivi de l'URI d'origination indiquée dans la section Connection details du trunk CallShift.

Champ	Côté Twilio
`phoneNumber`	Le numéro Twilio, au format E.164 (`+33187654321`)
`terminationUri`	La Termination SIP URI, par exemple `acme.pstn.twilio.com`
`transport`	`1` (UDP), le réglage par défaut de Twilio ; `3` (TLS) si vous activez Secure Trunking
`sipUsername`, `sipPassword`	Le nom d'utilisateur et le mot de passe de la liste d'identifiants
`requireInboundAuth`	`false` : Twilio n'envoie aucun identifiant avec les appels entrants

Numéro présenté. Twilio refuse un appel sortant qui ne présente ni un numéro du compte ni un numéro vérifié : le trunk appelle depuis son numéro Twilio.
Format E.164. Twilio rejette un numéro sans son + (400 Bad Request) et transmet les numéros entrants avec leur +.
Appels par seconde. Par défaut, un trunk Twilio passe 1 appel par seconde ; vous pouvez monter jusqu'à 5 dans ses réglages Termination, et davantage en passant par l'équipe commerciale de Twilio (guide Twilio). Appliquez la même limite au trunk CallShift : Twilio refuse les appels qui la dépassent.

Retirer un numéro

DELETE/v1/phones/sip/{phoneId} supprime le numéro et le détache de son trunk.