Getting started with Powerpack

Sending SMS messages using regular 10-digit phone numbers (a.k.a long codes) is heavily regulated in the US and Canada. Long codes, however, remain the medium of choice for businesses seeking to engage with their customers via SMS. The personalized touch long codes lend to a conversation, their price advantage, and the easy procurement process makes long codes a natural choice for most use cases.

Powerpack makes SMS communication using long codes effective and reliable at scale. It is designed to meet your overall SMS throughput and volume requirements, regardless of scale.

By automatically distributing your overall SMS traffic across a pool of source numbers, Powerpack keeps you compliant with per day and per second throughput limits defined by the CTIA (Cellular Telecommunications Industry Association).

Powerpack Features

  • Number pool - Powerpack intelligently distributes your outbound SMS traffic over a pool of source numbers optimal for your overall SMS volumes. Setting up a pool of source numbers that is just right for your SMS volumes only takes a few seconds.
  • Smart Sender - If your use case requires you to contact the same subscriber more than once, Smart Sender helps maintain a single thread of conversation by always sending messages to the subscriber from the same source number in the pool.

Creating a New Powerpack

To create a new powerpack

  1. Login to your Plivo Console dashboard.
  2. Navigate to the SMS Powerpack management console.

  3. On the SMS Powerpacks page, click Add New Powerpack.

  4. In the Properties section, enter a name for the new Powerpack.
  5. Enable Smart Sender if you’d like to ensure that messages to a particular destination number are always sent from the same Powerpack source number.
  6. In the Configure Number Pool section, enter your daily SMS volume for US and Canada. Plivo will recommend the optimal phone number pool size based on your input.
  7. Specify the Pool Size, and click Add Powerpack. This will initiate the purchasing and provisioning of phone numbers.

Sending messages using Powerpack

To send messages using Powerpack

  1. On the SMS Powerpack page, click All Powerpacks to view all of your Powerpacks.
  2. Copy the Powerpack ID for the powerpack you wish to use.

  3. Enter your Powerpack ID for powerpack_uuid in the Send SMS API request.

Code Samples

1
2
3
4
5
6
7
8
9
import plivo

client = plivo.RestClient()
message_created = client.messages.create(
    powerpack_uuid='the_powerpack_uuid',
    dst='the_destination_number',
    text='Hello, world!'
)
        
1
2
3
4
5
6
7
8
9
10
11
12
13
require 'rubygems'
require 'plivo'

include Plivo

client = RestClient.new
message_created = client.messages.create(
  nil,
  %w[your_destination_number_1 your_destination_number_2],
  'Hello, world!',
  powerpack_uuid: 'your_powerpack_uuid'
)
        
1
2
3
4
5
6
7
8
9
10
11
12
13
14
let plivo = require('plivo');
let client = new plivo.Client();

client.messages.create(
  null,
  'your_destination_number',
  'Hello, world!',
  {},
  'your_powerpack_uuid'
).then(function(message_created) {
  console.log(message_created)
})
    
        
1
2
3
4
5
6
7
8
9
10
11
12
require 'vendor/autoload.php';
use Plivo\RestClient;

$client = new RestClient();
$message_created = $client->messages->create(
    null,
    ['the_destination_number'],
    'Hello, world!',
    [],
    'the_powerpack_uuid'
);
        
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import com.plivo.api.Plivo;
import com.plivo.api.PlivoClient;
import com.plivo.api.exceptions.PlivoRestException;
import com.plivo.api.models.node.MultiPartyCall;
import com.plivo.api.models.node.MultiPartyCallActionType;
import com.plivo.api.models.node.MultiPartyCallUpdateResponse;
import com.plivo.api.models.phlo.Phlo;
import java.io.IOException;

class Example {
  public static void main(String [] args) {
    Plivo.init();
    Message.creator(Collections.singletonList("the_destination_number"), "Hello, world!", "the_powerpack_uuid")
                    .create();
  }
}
        
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
package main

import "github.com/plivo/plivo-go"

func main()  {
  client, err := plivo.NewClient("", "", &plivo.ClientOptions{})
  if err != nil {
    panic(err)
  }
  client.Messages.Create(plivo.MessageCreateParams{
    PowerpackUUID: "the_powerpack_uuid",
    Dst: "the_destination_number",
    Text: "Hello, world!",
  })
}
        

Updating a Powerpack

To modify or update your Powerpack

  1. On the SMS Powerpacks page, click All Powerpacks to view all of your Powerpacks.
  2. Select the Powerpack you wish to modify or update.
  3. In the Properties section, modify Smart Sender by enabling or disabling it, and then click Update.

  4. In the Number Pool Composition section, update the number count to change the Powerpack pool size, and then click Update.
    • If you are increasing the pool size, a dialogue box will prompt you to confirm the purchase of new numbers.
  5. You can also manually remove phone numbers from your number pool by clicking on View.

  6. Select Delete & Unrent against the number you wish to remove from your number pool.