Commencer


Original: http://www.sipsorcery.com/mainsite/Help/GettingStarted

 

En connectant votre appareil SIP
Création fournisseur dossiers
plans de numérotation
Traitement des appels entrants

En connectant votre appareil SIP

Les nouveaux comptes sont configurés avec un compte SIP qui vous permettra d’enregistrer votre appareil et d’effectuer des appels sortants à une musique sur le système de maintien. Les paramètres de configuration requis pour connecter votre appareil SIP vers les serveurs de SIPSorcery sont le strict minimum.

  • Nom d’utilisateur: Le nom d’utilisateur que vous avez signé avec
  • Mot de passe: Le mot de passe que vous avez signé avec
  • Serveur: sipsorcery.com

Notez que vous n’avez pas besoin d’entrer un proxy sortant, username auth etc etc Outre les trois domaines ci-dessus, vous pouvez normalement laisser tous les autres paramètres sur votre appareil SIP mis à leur valeur par défaut.

Création fournisseur dossiers

La prochaine étape la plupart des gens veulent prendre est de mettre en place un ou plusieurs enregistrements de fournisseurs SIP. Fournisseurs SIP sont des connexions à des services de 3e partie SIP qui offrent généralement des appels entrants et sortants, mais peuvent également être utilisés pour des services tels que la messagerie vocale ou RVI.

Pour créer un fournisseur SIP dossier, cliquez sur l’onglet fournisseur SIP et entrez les informations qui ont été fournies par votre fournisseur SIP. Normalement il n’est pas nécessaire d’entrer des paramètres avancés. Les paramètres requis sont énumérés ci-dessous.

  • Type de prestataire: Les options sont SIP ou Google Voice. L’option SIP crée une entrée standard pour intégrer une partie 3e fournisseur SIP. L’option Google Voice crée une entrée qui peut être utilisé pour passer des appels via le service Google Voice de Google. Pour utiliser Google Voice vous aurez besoin pour créer une connexion avec au moins un fournisseur SIP plus de détails peuvent être trouvés dans la section SIPSorcery Recettes en vertu de la recette Google Voice.
  • Nom du fournisseur: Le nom que vous souhaitez utiliser pour cette entrée de fournisseur. Vous aurez probablement besoin d’utiliser le nom du fournisseur dans votre plan de numérotation de sorte qu’il est préférable de garder le plus court et reconnaissable que possible.
  • Nom d’utilisateur: Le nom d’utilisateur pour le compte du fournisseur SIP.
  • Mot de passe: Le mot de passe pour le compte du fournisseur SIP.
  • Inscrivez-vous: Cochez cette case si vous souhaitez vous inscrire auprès de votre fournisseur SIP. Dans la plupart des cas, il vous suffit de vous inscrire auprès de votre fournisseur si vous voulez recevoir des appels de leur part. Si vous utilisez uniquement le fournisseur pour les appels sortants, vous n’avez pas besoin de vous enregistrer et vous devez laisser cette case vide.
  • Inscrivez-vous Contact: Si vous cochez la case de registre, vous devrez entrer une adresse SIP qui sera utilisé comme destination pour votre fournisseur d’envoyer les appels entrants vers. Une adresse SIP par défaut sera entré pour vous, qui est your_username@sipsorcery.com. Cette adresse se traduira par les appels entrants soient transférés vers votre compte principal SIPSorcery SIP. Vous êtes libre de modifier cette adresse et vous pouvez entrer une adresse IP valide, y compris celles externes à SIPSorcery.

plans de numérotation

Les plans de numérotation SIPSorcery sont ce contrôlent la façon dont les appels sont acheminés. SIPSorcery plans de numérotation peuvent être créés grâce à un assistant ou en écrivant un script Ruby; Ruby est un langage de script puissant moderne qui est étonnamment facile à utiliser même pour les novices. Le plus simple possible plan de numérotation de Ruby est indiqué ci-dessous.

1
2
# Hello World dial plan example.
sys.Dial("music@iptel.org")

Ce plan de numérotation enverra chaque appel à une musique enregistrée sur le serveur de maintien dirigé par iptel.org (la maison du célèbre serveur SER SIP). Ce n’est pas un plan de numérotation très utile, mais il ne le rendent facile à tester que votre ATA ou téléphone est correctement connecté à SIPSorcery.

Un exemple d’un plan de numérotation de Ruby plus pratique est illustré ci-dessous.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# Practical dial plan example.
sys.Log("New outgoing call received to #{req.URI.User}.")
case req.URI.User
  # Speed dials.
  when "100" then sys.Dial("subaccount1@sipsorcery.com")
  when "101" then sys.Dial("subaccount2@sipsorcery.com")
  # Prefix dialling for providers.
  when /^\*1/ then sys.Dial("${EXTEN:2}@provider1")
  when /^\*2/ then sys.Dial("${EXTEN:2}@provider2")
  # PSTN calls.
  when /^[1-9]/ then sys.Dial("${EXTEN}@local_pstn_provider")
  when /^00[1-9]/ then sys.Dial("${EXTEN}@international_pstn_provider")
  else sys.Respond(404, "Oops no dial plan rule found for destination")
end

Une explication de chaque section dans le plan de numérotation ci-dessus suit.

# Practical dial plan example.

Les lignes qui commencent par un # sont des commentaires et sont à titre informatif seulement.

sys.Log(“New outgoing call received to #{req.URI.User}.”)

sys.Log est une méthode ou une fonction qui peut être appelée dans un plan de numérotation pour imprimer un message de log à la console SIPSorcery. Dans le message du journal l’# {req.URI.User} représente une variable d’inclure dans le message du journal, l’objet de req.URI.user sera expliqué dans la section suivante.

case req.URI.User

Cette ligne est le début d’une affaire ou instruction switch. Il fonctionne en essayant de faire correspondre les expressions dans la déclaration de cas de prendre une décision sur un certain type d’action à prendre. La partie req.URI.User représente une variable qui est préremplie par le serveur SIPSorcery et qui contient la destination de l’appel qui a initié le plan de numérotation. Le peu de req signifie demande et représente la requête SIP d’ouverture.

when “100” then sys.Dial(“subaccount1@sipsorcery.com”)

Cette ligne est l’une des expressions de la déclaration des cas. Il vérifie si le numéro composé est égale à 100 et si oui prend l’action de la numérotation subaccount1@sipsorcery.com. Ce type de match est une forme de cadran de vitesse. Par correspondance sur un numéro court 100 comme il permet souvent à des destinations abrégées composé.

when /^\*1/ then sys.Dial(“${EXTEN:2}@provider1”)

Cette ligne est également l’une des expressions de la déclaration de cas, mais contrairement à la précédente, il utilise une expression régulière pour correspondre à la destination composé. Les expressions régulières sont un moyen extrêmement puissant et flexible pour faire modèle de texte correspondant. Dans ce cas, l’expression régulière reconnaît toutes les destinations qui commencent par un préfixe * 1 et lorsque jumelés à l’avant l’appel à $ {EXTEN: 2} @ provider1. Le $ {} EXTEN modèle représente le nombre qui a été composé donc par exemple si l’appel initial était * 1234 alors $ {} EXTEN serait également * 1234. L’: 2 à la fin de $ {EXTEN: 2} indique que les deux premiers caractères doivent être coupés dès le début si $ {2}: extension seraient 234.

when /^[1-9]/ then sys.Dial(“${EXTEN}@local_pstn_provider”)

Cette ligne est semblable à la précédente mais dans ce cas, c’est l’intention est d’identifier les appels qui sont pour le réseau téléphonique traditionnel ou PSTN et les transmet par l’intermédiaire du fournisseur approprié. Le point clé est que, en appliquant des règles différentes à des numéros RTPC différents fournisseurs peuvent être utilisés. Ainsi, par exemple différents fournisseurs peuvent être utilisés pour les appels fixes locaux, les appels mobiles et les appels internationaux.

else sys.Respond(404, “Oops no dial plan rule found for destination”)

C’est la dernière ligne de la déclaration de cas et son but est d’envoyer une réponse d’erreur SIP à l’appelant pour indiquer que le plan de numérotation ne contient pas de règle de correspondance de leur appel.

Traitement des appels entrants

Contrairement aux appels sortants qui sont toujours traitées par un plan de numérotation des appels entrants peuvent être traités de deux manières différentes.

Lorsqu’un appel entrant est reçu pour un compte SIP SIPSorcery comme sip: myaccount@sipsorcery.com le comportement par défaut est de transférer l’appel vers tous les téléphones ATA et qui sont enregistrés au compte myaccount@sipsorcery.com SIP. Cela signifie qu’il est très facile de recevoir des appels et les faire transmettre directement à un téléphone ou ATA comme aucun script de plan de numérotation ou l’intervention est nécessaire.

Lorsque le traitement des appels entrants plus sophistiquée est nécessaire, il est possible d’utiliser un plan de numérotation pour traiter l’appel de la même manière comme un appel sortant. Pour que cela fonctionne le compte SIP SIPSorcery l’appel entrant est reçu pour les besoins d’avoir un ensemble de plan de numérotation entrante. L’onglet compte SIP permet toutes les propriétés d’un compte SIP à gérer, y compris le plan de numérotation entrant et sortant.

Pour les appels entrants il est souvent souhaitable d’avoir des appels de différents fournisseurs traitées de différentes manières. Le moyen le plus rapide pour atteindre cet utilise un plan de numérotation entrante. Les étapes sont décrites ci-dessous.

  • Si vous ne voulez pas changer le comportement de votre compte SIP principal puis créer un nouveau compte SIP pour la réception d’appels et de vérifier la seule case entrant. Il s’agit du compte que le plan de numérotation entrant devra être mis dans une étape ultérieure. Pour cet exemple, supposons que le compte SIP a été créé avec un nom d’utilisateur de fredsin.
  • Pour chaque fournisseur que vous souhaitez traiter les appels entrants pour définir le contact de registre à provider_name.fredsin @ sipsorcery.com. Ainsi, par exemple si vous aviez un fournisseur nommé sipgate et Callcentric les contacts de registre pour eux serait sipgate.fredsin @ sipsorcery.com et callcentric.fredsin @ sipsorcery.com respectivement (noter que si vous mettez à jour le registre de contact sur un fournisseur déjà vous inscrire il peut prendre jusqu’à 30 secondes pour que la nouvelle liaison à appliquer, c’est à éviter sur les fournisseurs de chargement avec les demandes d’enregistrement).
  • Créer un nouveau plan de numérotation, il peut être appelé autrement que pour cet exemple, nous allons appeler fredsinplan. Le contenu du plan de numérotation sont affichés ci-dessous.
  • Définir le plan de numérotation entrant pour le compte fredsin SIP à fredsinplan.

Ces mesures se traduiront par des appels pour chacun des fournisseurs qui sont envoyées au plan de numérotation fredsinplan où ils peuvent être traités au besoin.

1
2
3
4
5
6
7
8
# Incoming dial plan example.
sys.Log("New incoming call received to #{req.URI.User} from #{req.Header.From.ToString()}.")
case req.URI.User
  when "sipgate.fredsin" then sys.Dial("1234@provider1")
  when "callcentric.fredsin" then sys.Dial("5678@provider2")
  else sys.Dial("youraccount@sipsorcery.com")
end

The structure of this dial plan is almost identical to the outgoing dial plan in the Dial Plans section and the explanation for it applies as well. The difference is now that instead of processing an outgoing call from your ATA or phone the call is now an incoming one from one of your SIP providers. By matching on the call destination it’s possible to determine which provider forwarded the call and different actions can be taken appropriately.

entric.fredsin” alors sys.Dial (“5678 @ provider2”)
autre sys.Dial (“youraccount@sipsorcery.com”)
fin

La structure de ce plan de numérotation est presque identique au plan de numérotation sortante dans la section des plans de numérotation et l’explication pour qu’elle s’applique aussi bien. La différence est que maintenant au lieu de traiter un appel sortant de votre ATA ou téléphone l’appel est maintenant un un entrant d’un de vos fournisseurs SIP. Par correspondance sur la destination de l’appel, il est possible de déterminer quel fournisseur a transmis l’appel et différentes mesures peuvent être prises de manière appropriée.

Comments are closed.