Recommended
More Related Content
What's hot
What's hot (20)
More from Jöran Vinzens
More from Jöran Vinzens (10)
Recently uploaded
Recently uploaded (20)
Using ARI and AGI to Connect Asterisk Instances
- 1. 1
- 2. Using ARI and AGI to Connect Asterisk Instances in a Large Scale Environment 2
- 3. Using ARI and AGI 3 Jöran Vinzens sipgate VoIP developer 11 years at sipgate >20 years in VoIP
- 4. Using ARI and AGI 4 What is this talk about?
- 5. Using ARI and AGI 5 Architecture! not so much about code
- 6. Using ARI and AGI 6 Agenda 01 Basics 02 AGI vs ARI 03 Why ARI 04 How to interact 05 Call Handling with multiple Instances 06 Random Tips and Tricks
- 7. Using ARI and AGI 7 Basics Start at the beginning
- 8. Using ARI and AGI 8 Basics Start at the beginning PBX Alice Bob Charli e Ed David Trunk Carrier
- 9. Using ARI and AGI 9 Start at the beginning Basics Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio Kamailio Kamailio Carrier
- 10. Using ARI and AGI 10 Start at the beginning Basics Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio Kamailio Kamailio Carrier
- 11. Using ARI and AGI 11 Basics Start at the beginning Dialplan extensions.conf
- 12. Using ARI and AGI 12 Basics Asterisk dialplan exten = 10,1,Log(INFO, Hello World)
- 13. Using ARI and AGI 13 Basics Asterisk dialplan exten = 10,1,Log(INFO, Hello World) extension priority application parameter
- 14. Using ARI and AGI 14 Basics Asterisk dialplan exten = 10,1,Log(INFO, Hello World) same = n,Answer() same = n,Playback(tt-monkeys) same = n,Hangup()
- 15. Using ARI and AGI 15 Basics Asterisk dialplan exten = _XN.,1,Dial(PJSIP/${EXTEN}@trunk-out,120tr)
- 16. Using ARI and AGI 16 Basics https://wiki.asterisk.org/wiki/display/AST/Asterisk+20+Application_Dial
- 17. Using ARI and AGI 17 Basics Asterisk dialplan there are never enough features
- 18. Using ARI and AGI 18 Basics Asterisk dialplan AGI ARI AMI
- 19. Using ARI and AGI 19 AGI vs ARI Asterisk dialplan AGI Asterisk Gateway Interface ARI Asterisk REST Interface
- 20. Using ARI and AGI 20 AGI vs ARI What is that?
- 21. Using ARI and AGI 21 AGI vs ARI AGI / FastAGI Trigger external script Query external service
- 22. Using ARI and AGI 22 AGI vs ARI AGI "AGI is analogous to CGI in Apache. AGI provides an interface between the Asterisk dialplan and an external program that wants to manipulate a channel in the dialplan. In general, the interface is synchronous - actions taken on a channel from an AGI block and do not return until the action is completed." https://wiki.asterisk.org/wiki/pages/viewpage.action?pageId=32375589
- 23. Using ARI and AGI 23 AGI vs ARI AGI Use Cases?
- 24. Using ARI and AGI 24 AGI vs ARI AGI use cases DB lookups LCR lookup External accounting
- 25. Using ARI and AGI 25 AGI vs ARI Asterisk dialplan exten = _XN.,1,AGI(someLogic.agi) exten = _XN.,1,AGI(agi://1.2.3.4:1234/entrypoint)
- 26. Using ARI and AGI 26 AGI vs ARI AGI ● Dialplan application ● Only when dialplan is processed ● Blocks Dialplan ● No control during call
- 27. Using ARI and AGI 27 AGI vs ARI ARI Websocket / REST Interface
- 28. Using ARI and AGI 28 AGI vs ARI ARI "ARI is an asynchronous API that allows developers to build communications applications by exposing the raw primitive objects in Asterisk - channels, bridges, endpoints, media, etc. - through an intuitive REST interface." https://wiki.asterisk.org/wiki/pages/viewpage.action?pageId=29395573
- 29. Using ARI and AGI 29 AGI vs ARI Asterisk dialplan exten = _XN.,1,Stasis(myStasisApp)
- 30. Using ARI and AGI 30 AGI vs ARI JSON { "application":"hello-world", "type":"StasisStart", "timestamp":"2014-05-20T13:15:27.131-0500", "args":[], "channel":{ "id":"1400609726.3", "state":"Up", "name":"PJSIP/1000-00000001", "caller":{ "name":"", "number":""}, "connected":{ "name":"", "number":""}, "accountcode":"", "dialplan":{ "context":"default", "exten":"1000", "priority":1}, "creationtime":"2014-05-20T13:15:26.628-0500"} }
- 31. Using ARI and AGI 31 AGI vs ARI ARI ● Basic building blocks ● Blocks Dialplan ● JSON
- 32. Using ARI and AGI 32 AGI vs ARI ARI building blocks ● Channels ● Bridges ● Playbacks ● Recordings ● ...
- 33. Using ARI and AGI 33 AGI vs ARI ARI building blocks Channel Channel Bridge
- 34. Using ARI and AGI 34 ARI building blocks AGI vs ARI Channel Channel Bridge Asterisk Alice Bob SIP Invite - PJSIP Channel POST ari/channels/create - PJSIP Channel
- 35. Using ARI and AGI 35 AGI vs ARI ARI 1. PJSIP channel incoming Invite 2. Dialplan App Stasis() -> StasisStart 3. REST POST bridge create 4. REST POST channel create 5. REST POST bridge add both channels 6. REST POST channel dial 7. PJSIP channel outgoing Invite
- 36. Using ARI and AGI 36 AGI vs ARI ARI ● More work than dialplan ● More components than asterisk only ● Yet another API to learn ● ... Why should one do that?
- 37. Using ARI and AGI 37 AGI vs ARI ARI Flexibility
- 38. Using ARI and AGI 38 How to interact AGI and ARI Why use both?
- 39. Using ARI and AGI 39 How to interact AGI and ARI e.g. select Stasis App in AGI
- 40. Using ARI and AGI 40 How to interact AGI and ARI exten = _XN.,1,Agi(selectStasisApp.agi) same = n,Log(NOTICE, AGI selected ARI App: ${STASISAPP}) same = n,Stasis(${STASISAPP})
- 41. Using ARI and AGI 41 ARI primitive objects AGI vs ARI Dialplan Channel Asterisk Alice Bob SIP Invite - PJSIP Channel POST ari/channels/create - PJSIP Channel AGI ARI Bridge
- 42. Using ARI and AGI 42 How to interact AGI and ARI What if we want to call an AGI on a ARI initiated call?
- 43. Using ARI and AGI 43 ARI primitive objects AGI vs ARI Channel -> Dialplan Channel Asterisk Alice Bob SIP Invite - PJSIP Channel POST ari/channels/create - PJSIP Channel AGI ARI Bridge AGI
- 44. Using ARI and AGI 44 How to interact AGI and ARI The magic of Local Channel
- 45. Using ARI and AGI 45 How to interact What is a local Channel? Channel Channel app_dial Asterisk Alice Bob PJSIP Channel PJSIP Channel
- 46. Using ARI and AGI 46 How to interact What is a local Channel? Channel Channel app_dial Asterisk Alice Bob PJSIP Channel PJSIP Channel app_dial Channel Local Channel
- 47. Using ARI and AGI 47 How to interact How to use local Channels with Stasis? Channel Channel app_dial Asterisk Alice Bob PJSIP Channel PJSIP Channel app_dial Channel Local Channel
- 48. Using ARI and AGI 48 How to interact How to use local Channels with Stasis? Channel Channel app_stasis Asterisk Alice Bob PJSIP Channel PJSIP Channel app_dial Channel Local Channel
- 49. Using ARI and AGI 49 How to interact How to use local Channels with Stasis? Channel Channel app_stasis Asterisk Alice Bob PJSIP Channel PJSIP Channel app_dial Channel Local Channel AGI AGI
- 50. Using ARI and AGI 50 How to interact AGI and ARI Alice AGI Stasis Dial AGI determine Stasis App control over the entire call place Local Channel Check Wholesale Carrier (LCR) place call Carrier
- 51. Using ARI and AGI 51 Call handling with multiple Instances Connect Asterisk instances?
- 52. Using ARI and AGI 52 Call handling with multiple Instances Connect Asterisk instances? First, a scenario
- 53. Using ARI and AGI 53 Call handling with multiple Instances Connect Asterisk instances? First, a scenario Pickup a call!
- 54. Using ARI and AGI 54 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio
- 55. Using ARI and AGI 55 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio
- 56. Using ARI and AGI 56 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio AGI What Stasis App? ARI Call control
- 57. Using ARI and AGI 57 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio AGI What Stasis App? ARI Call control AGI What Stasis App?
- 58. Using ARI and AGI 58 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio AGI What Stasis App? ARI Call control AGI What Stasis App?
- 59. Using ARI and AGI 59 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio AGI What Stasis App? ARI Call control AGI What Stasis App?
- 60. Using ARI and AGI 60 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio AGI What Stasis App? ARI Call control AGI What Stasis App?
- 61. Using ARI and AGI 61 Call handling with multiple Instances Drawbacks ● Complex call routing ● Nothing for free from Asterisk ● Yet another API ● Shared knowledge over instances
- 62. Using ARI and AGI 62 Call handling with multiple Instances Benefits ● Scaling ● Reduce fallout on crash ● REST / Websocket ● Enforced boundaries
- 63. Using ARI and AGI 63 Call handling with multiple Instances Drawbacks Single point of Failure
- 64. Using ARI and AGI 64 Call handling with multiple Instances Kamailio Alice Bob Charlie Asterisk Asterisk Asterisk Asterisk Carrier Kamailio AGI What Stasis App? ARI Call control AGI What Stasis App?
- 65. Using ARI and AGI 65 Call handling with multiple Instances Asterisk Asterisk Asterisk Asterisk ARI ARI ARI ARI
- 66. Using ARI and AGI 66 Call handling with multiple Instances Asterisk Asterisk Asterisk Asterisk ARI ARI Use an ARI Proxy Kafka / RabbitMQ / NATS ARI Proxy ARI Proxy ARI Proxy ARI Proxy
- 67. Using ARI and AGI 67 Call handling with multiple Instances Asterisk Asterisk Asterisk Asterisk ARI ARI Use an ARI Proxy Kafka / RabbitMQ / NATS ARI Proxy ARI Proxy ARI Proxy ARI Proxy Control callflow ARI connection
- 68. Using ARI and AGI 68 Call handling with multiple Instances ARI Proxy CyCoreSystems https://github.com/CyCoreSystems/ari-proxy - NATS / RabbitMQ retel-io https://github.com/retel-io/ari-proxy - Kafka (Kafka sample https://github.com/vinzens81/ari-controller)
- 69. Using ARI and AGI 69 Call handling with multiple Instances Nice picture here!