SIP

SIP Phones are the same thing as VoIP Phones or Soft phones. These are telephones that use VoIP technologies for making calls over an IP Network or the traditional PSTN networks.

Using AfricasTalking voice API, you can call a SIP phone from a normal phone number and vice versa.

Configuring a SIP/Soft phone

To receive incoming or make outgoing calls using SIP, you need to have a soft phone or a SIP client. To get SIP credentials you should request for a SIP number from your Africa's Talking dashboard. These credentials are:

USERNAME: name.MyAfricasTalkinUsername@country.sip.africastalking.com e.g test.demo@ke.sip.africastalking.com,
PASSWORD: . This is retrieved from your dashboard under Voice -> Phone Numbers.,
DOMAIN: For Kenya, it will be ke.sip.africastalking.com; For Uganda, ug.sip.africastalking.com; For Nigeria, ng.sip.africastalking.com,
REGISTER: true

Receiving calls on a SIP client/SIP Phone

To receive incoming calls via your SIP phone from normal number, you require a virtual number provisioned by us. We will then notify you of incoming calls to this number via a HTTP POST request to your Voice API callback URL. You can then respond with a Dial action, asking us to forward the call to the SIP number above.

For example a response would be:

<Response>
    <Dial phoneNumbers="test.myafricastalkingusername@ke.sip.africastalking.com"/>
</Response>

You should then configure your SIP client with the credentials provided and the call will automatically be forwarded to your SIP client/SIP phone.

NOTE:

The call will be directly bridged with your sip client and will not be sent to your callback url.

Calling from a SIP client/SIP Phone

In order to make outbound call, you will dial the number on your soft phone or sip client. We will notify you of outgoing calls from your sip number. You can then respond with a Dial action, asking us to forward the call to the number dialed.

In order to receive incoming calls via your SIP phone from normal number, you will need to get a virtual number from us (+254711082XXX). We will forward incoming calls to this callback URL. You can then respond with a Dial action, asking us to forward the call to the SIP number above.

For example a response would be:

<Response>
  <Dial phoneNumbers="+254XXXYYYZZZ"/>
</Response>