Connecter votre téléphonie en SIP

Vous disposez déjà d'une infrastructure téléphonique — IPBX, SBC ou cœur de réseau opérateur ? Le trunk SIP Manivox vous permet d'envoyer vos appels directement en SIP vers vos agents, sans détour par le réseau téléphonique public.

Vue d'ensemble

Le trunk SIP interconnecte votre réseau et celui de Manivox pour acheminer vos appels en IP : vos équipements envoient les appels en SIP, la plateforme les route vers l'agent assigné au numéro composé, exactement comme pour un appel entrant classique — enregistrement d'appel, variables système et nœud Welcome compris.

Seuls les appels à destination des numéros (SDA) de vos agents sont acceptés ; tout autre appel est rejeté avec un code SIP 403 Forbidden.

L'essentiel en un coup d'œil :

Paramètre	Valeur
Adresse du SBC	`sbc.manivox.ai` (`185.101.180.103`)
Signalisation	SIP sur TLS (port `5061`, recommandé) ou SIP sur UDP (port `5060`)
Authentification	Par adresse IP source, sur les deux transports
Média	RTP sur UDP, ports `8000` à `65000`, relayé par Manivox
Chiffrement média	SRTP (SDES), disponible avec le transport TLS
Codecs	G711a (PCMA), G711u (PCMU), G729a (ptime 20 ms, maxptime 40 ms)

Avant de commencer — transmettez à votre contact Manivox la ou les adresses IP publiques à l'origine de vos appels. C'est cette adresse IP qui identifie et autorise votre trunk : il n'y a ni login ni mot de passe à configurer. Pensez aussi à ouvrir votre pare-feu pour les flux média (voir Flux média).

Signalisation SIP

Manivox accepte votre trafic SIP sur deux transports, au choix.

Transport	Adresse	Port
SIP sur TLS (recommandé)	`sbc.manivox.ai`	`5061`
SIP sur UDP	`sbc.manivox.ai`	`5060`

sbc.manivox.ai résout vers 185.101.180.103. Le TLS 1.2 et le TLS 1.3 sont acceptés. Le SIP sur TCP sans TLS n'est pas supporté.

L'authentification reste fondée sur l'adresse IP source sur les deux transports : votre adresse publique doit nous être déclarée au préalable, y compris en TLS.

Côté pare-feu, ouvrez le TCP sortant vers sbc.manivox.ai:5061 et autorisez les connexions TLS entrantes depuis 185.101.180.103 : certaines requêtes en cours d'appel peuvent être établies à notre initiative.

Flux média (RTP)

Paramètre	Valeur
Transport	RTP sur UDP
Plage de ports	`8000` à `65000`
IP sources du média Manivox	`185.101.180.64/26`
Chiffrement	SRTP (SDES), avec le transport TLS

Le média est toujours relayé par nos serveurs : les flux RTP ne s'établissent jamais directement entre votre équipement et le poste distant.

Le flux média peut provenir de plusieurs passerelles du réseau Manivox. Autorisez l'ensemble de la plage 185.101.180.64/26 dans votre pare-feu — pas uniquement l'adresse du SBC — sous peine d'appels établis mais sans audio.

Chiffrement du média (SRTP)

Le SRTP est disponible avec échange de clés SDES (RFC 4568), conjointement au transport TLS : les clés étant portées dans le SDP, elles n'auraient pas de sens sur une signalisation en clair.

Proposez un profil RTP/SAVP dans votre SDP avec au moins une des suites suivantes ; nous répondons sur le même profil.

Suite
`AES_256_CM_HMAC_SHA1_80`
`AES_256_CM_HMAC_SHA1_32`
`AES_CM_128_HMAC_SHA1_80`
`AES_CM_128_HMAC_SHA1_32`

DTLS-SRTP et ZRTP ne sont pas supportés. Les attributs ICE présents dans votre SDP sont retirés, le média étant systématiquement relayé.

Codecs

Les codecs audio supportés sont G711a (PCMA), G711u (PCMU) et G729a.

Dans tous les cas, le temps de paquétisation (ptime) doit être de 20 ms et le maxptime de 40 ms.

Formats de numérotation

Trois formats sont acceptés, aussi bien pour le numéro appelé que pour le numéro appelant :

Format	Numéro appelé (exemple)	Numéro appelant (exemple)
00 + E.164	`0033987654321`	`0033123456789`
+E.164	`+33987654321`	`+33123456789`
E.164	`33987654321`	`33123456789`

Exemples d'INVITE SIP

En UDP

Un INVITE typique tel qu'attendu par le SBC Manivox sur le transport UDP :

INVITE sip:33987654321@sbc.manivox.ai;transport=UDP SIP/2.0
Max-Forwards: 70
Contact: <sip:33123456789@1.1.1.1:60802;transport=UDP>
To: <sip:33987654321@sbc.manivox.ai>
From: "33123456789"<sip:33123456789@sbc.manivox.ai;transport=UDP>;tag=7cb8fe3d
Call-ID: QAHzE3s-BpUtu98qZRSOrA..
CSeq: 1 INVITE
Allow: INVITE, ACK, CANCEL, BYE, OPTIONS
Content-Type: application/sdp
Supported: replaces
Content-Length: 185

v=0
o=Z 0 2418412530 IN IP4 1.1.1.1
s=Z
c=IN IP4 1.1.1.1
t=0 0
m=audio 55961 RTP/AVP 8 101
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-16
a=sendrecv

En TLS

Le même type d'appel sur le transport TLS, avec chiffrement du média (profil RTP/SAVP) :

INVITE sip:+33176360001@sbc.manivox.ai;transport=tls SIP/2.0
Via: SIP/2.0/TLS 203.0.113.10:5061;branch=z9hG4bK4f2a1c;rport
From: <sip:+33612345678@trunk.exemple.fr>;tag=a1b2c3
To: <sip:+33176360001@sbc.manivox.ai>
Call-ID: 8f3c1e2a-4b7d-11f0-9c1a-0242ac120002
CSeq: 1 INVITE
Contact: <sip:+33612345678@203.0.113.10:5061;transport=tls>
Max-Forwards: 70
X-MAI-Custom1: 4711829
Content-Type: application/sdp
Content-Length: ...

v=0
o=- 3945678123 3945678123 IN IP4 203.0.113.10
s=-
c=IN IP4 203.0.113.10
t=0 0
m=audio 40012 RTP/SAVP 8 0 101
a=rtpmap:8 PCMA/8000
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000
a=crypto:1 AES_CM_128_HMAC_SHA1_80 inline:PS1uQCVeeCFCanVmcjkpPywjNWhcYD0mXXtxaVBR
a=ptime:20
a=maxptime:40
a=sendrecv

Le Contact doit porter une adresse et un port sur lesquels vous acceptez une connexion TLS entrante. Les en-têtes personnalisés fonctionnent à l'identique sur les deux transports.

Votre trunk peut joindre des données applicatives à chaque appel (identifiant client, code campagne…) via les en-têtes X-MAI-Custom1 à X-MAI-Custom5 de l'INVITE. L'agent les lit dans des variables d'init, utilisables dès le message d'accueil. Voir En-têtes SIP.

Types d'interconnexion

Par Internet

L'interconnexion au travers du réseau Internet public est la plus simple à mettre en œuvre : aucun lien dédié n'est nécessaire. Dans ce cas, la qualité de service dépend de la qualité de votre lien Internet.

Par lien privé (POP client)

Pour des exigences de qualité ou de sécurité renforcées, l'interconnexion SIP peut être couplée à une offre de collecte LAN-to-LAN entre votre site et le POP Manivox. Les échanges SIP et RTP sont alors sécurisés via un lien privé de niveau 2 ou 3, selon vos contraintes. Parlez-en à votre contact Manivox.

Appels entrants

En-têtes SIP