Introducing Default Call Queuing, Plus Increased Visibility into Outbound Calls

24 Oct 2018

As part of our latest Voice product release, we’re introducing default queuing for outbound calls, as well as two new APIs to provide more visibility into your calls.

Before now, you needed to throttle calls per second (CPS) and queue outbound calls at your end, or you could request that our support team activate throttling and queuing for your account. Now we’re enabling them by default. Your calls will be queued in the calling sequence and initiated per the CPS set for your account.

If you’re a new user or you signed up on or after September 24, 2018, outbound API call queuing is enabled by default, and the default CPS is two calls per second. If you require a higher CPS rate, please contact Plivo support. We can provide higher CPS at a monthly price and based on your use case.

If you’re an existing Plivo customer and don’t have throttling enabled already, contact our customer support team to get started. We haven’t enabled this feature for existing customer accounts to avoid a sudden change in account behavior.

New APIs for queued outbound calls

We’re also introducing two new APIs to provide customers visibility into their queued calls:

Retrieve all queued calls: Overall queue management at any given time

        import plivo
        client = plivo.RestClient()
        response = client.queued_calls.list_ids()
        print(response)

        package com.plivo.api.samples.livecall;
    import java.io.IOException;
    import com.plivo.api.Plivo;
    import com.plivo.api.exceptions.PlivoRestException;
    import com.plivo.api.models.call.QueuedCall;
    import com.plivo.api.models.call.QueuedCallListResponse;
    
     // Example for QueuedCall list
    
    class QueuedCallList {
    		public static void main(String [] args) {
      				Plivo.init("<auth_id>","<auth_token>");
      				try {
          				QueuedCallListResponse response = QueuedCall.listGetter().get();
          				System.out.println(response);
      				} catch (PlivoRestException | IOException e) {
          				e.printStackTrace();
      				}
    		}
    }

        package main
        import "fmt"
        import "github.com/plivo/plivo-go/v7"
    
        func main() {
        	client, err := plivo.NewClient("<auth_id>","<auth_token>", &plivo.ClientOptions{})
        	if err != nil {
        	panic(err)
        	}
        	response, err := client.QueuedCalls.IDList()
        	if err != nil {
        	panic(err)
        	}
        	fmt.Printf("Response: %#v\n", response)
        }

        require 'rubygems'
        require 'plivo'
    
        include Plivo
        include Plivo::Exceptions
    
        api = RestClient.new("<auth_id>","<auth_token>")
    
        begin
        		response = api.calls.list_queued()
        		  puts response
        rescue PlivoRESTError => e
        		  puts 'Exception: ' + e.message
        end

        var plivo = require('plivo');
        (function main() {
          		'use strict';
    
        		// As the auth_id and auth_token are unspecified, Plivo will fetch them from the PLIVO_AUTH_ID and PLIVO_AUTH_TOKEN environment variables.
        			var client = new plivo.Client("<auth_id>","<auth_token>");
        			client.calls.listQueuedCalls(
          		).then(function (response) {
         			   console.log(response);
          		}, function (err) {
         		   	console.error(err);
        		 	});
        })();

        require 'vendor/autoload.php';
    use Plivo\RestClient;
    $client = new RestClient("<auth_id>","<auth_token>");
    try {
    			$response = $client->calls->listQueued();
    			print_r($response);
    }
    catch (PlivoRestException $ex) {
    			print_r($ex);
    }

        using System;
    using System.Collections.Generic;
    using Plivo;
    using Plivo.Exception;
    
    namespace PlivoExamples
    {
    		internal class Program
    		{
      			public static void Main(string[] args)
      			{
          		var api = new PlivoApi("<auth_id>","<auth_token>");
          		try
          		{
              			var response = api.Call.ListQueued();
              			Console.WriteLine(response);
          		}
          		catch (PlivoRestException e)
          		{
              			Console.WriteLine("Exception: " + e.Message);
          		}
      			}
    		}
    }

Retrieve a queued call: To fetch details of a particular queued call

        import plivo
        client = plivo.RestClient('<auth_id>','<auth_token>')
        response = client.queued_calls.get('10f0cb68-7533-45ed-acb5-87ceac29ee48')
        print(response)

        package com.plivo.api.samples.livecall;
    import java.io.IOException;
    import com.plivo.api.Plivo;
    import com.plivo.api.exceptions.PlivoRestException;
    import com.plivo.api.models.call.LiveCall;
    
    // Example for QueuedCall get
    
    class QueuedCallGet {
    		public static void main(String [] args) {
        		Plivo.init("<auth_id>","<auth_token>");
        		try {
            		QueuedCall response = QueuedCall.getter("eba53b9e-8fbd-45c1-9444-696d2172fbc8")
                    		.get();
    
            		System.out.println(response);
        		} catch (PlivoRestException | IOException e) {
            		e.printStackTrace();
        		}
    	}
    }

        package main
      	import "fmt"
      	import "github.com/plivo/plivo-go/v7"
    
      	func main() {
      	client, err := plivo.NewClient("<auth_id>","<auth_token>", &plivo.ClientOptions{})
      	if err != nil {
      		panic(err)
      	}
      	response, err := client.QueuedCalls.Get
      (
      		"d6b00702-f7e2-49c9-9a90-5921c6602788",
      	)
      	if err != nil {
      		panic(err)
      	}
      	fmt.Printf("Response: %#v\n", response)
      }

        require 'rubygems'
      	require 'plivo'
      		include Plivo
      		include Plivo::Exceptions
    
      		api = RestClient.new("<auth_id>","<auth_token>")
    
      		begin
        			response = api.calls.get_queued(
          			'd6b00702-f7e2-49c9-9a90-5921c6602788'
        			)
        			puts response
      		rescue PlivoRESTError => e
        			puts 'Exception: ' + e.message
      		end

        var plivo = require('plivo');
    	(function main() {
      			'use strict';
    
      		// As the auth_id and auth_token are unspecified, Plivo will fetch them from the PLIVO_AUTH_ID and PLIVO_AUTH_TOKEN environment variables.
      			var client = new plivo.Client("<auth_id>","<auth_token>");
      			client.calls.getQueuedCall(
         			 "d6b00702-f7e2-49c9-9a90-5921c6602788", // call uuid
      			).then(function (response) {
          				console.log(response);
      			}, function (err) {
          			console.error(err);
      			});
    	})();

        require 'vendor/autoload.php';
    	use Plivo\RestClient;
    	$client = new RestClient("<auth_id>","<auth_token>");
    	try {
    			$response = $client->calls->getQueued(
        			'd6b00702-f7e2-49c9-9a90-5921c6602788'
    			);
    			print_r($response);
    	}
    	catch (PlivoRestException $ex) {
    			print_r($ex);
    	}

          using System;
          using System.Collections.Generic;
          using Plivo;
          using Plivo.Exception;
          namespace PlivoExamples
          {
              internal class Program
              {
                  public static void Main(string[] args)
                  {
                      var api = new PlivoApi("<auth_id>","<auth_token>");
                      try
                      {
                          var response = api.Call.GetQueued("d6b00702-f7e2-49c9-9a90-5921c6602788"
                          );
                          Console.WriteLine(response);
                      }
                      catch (PlivoRestException e)
                      {
                          Console.WriteLine("Exception: " + e.Message);
                      }
                  }
              }
          }

Don’t have a Plivo account? Sign up for free.