Blast RCS to Audience | Pinnacle

Send an RCS message to all contacts in an audience.

Messages are distributed evenly across the provided RCS agents for load balancing. Requires active RCS agents and recipient devices that support RCS Business Messaging.

Use the optional schedule parameter in options to schedule the blast for future delivery. When scheduled, the response will contain a scheduleId instead of blast details.

Send an RCS message to all contacts in an audience. <br> Messages are distributed evenly across the provided RCS agents for load balancing. Requires active RCS agents and recipient devices that support RCS Business Messaging. <br> Use the optional `schedule` parameter in `options` to schedule the blast for future delivery. When scheduled, the response will contain a `scheduleId` instead of blast details.

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

audienceIdstringRequiredformat: "^aud_"

The audience ID to send the blast to. This identifier is a string that always begins with the prefix aud_, for example: aud_abc123.

You can create an audience via the dashboard or API.

The audience ID to send the blast to. This identifier is a string that always begins with the prefix `aud_`, for example: `aud_abc123`. <br> You can create an audience via [the dashboard](https://app.pinnacle.sh/dashboard/audiences) or [API](/api-reference/audiences/create).

senderslist of stringsRequired

Array of RCS agent IDs to send from. Each must be prefixed with agent_.

Messages will be evenly distributed across these agents.

Note: Test agents cannot be used for blasts.

Limit: 1 min

messageobjectRequired

optionsobjectOptional

Configure how your RCS blast is sent and tracked.

Response

Successfully queued or scheduled the RCS blast.

Immediate blast: Returns blast details including total recipients, messages, segments, and cost.
Scheduled blast: Returns a scheduleId and the schedule configuration.

Successfully queued or scheduled the RCS blast. <br> - **Immediate blast**: Returns blast details including total recipients, messages, segments, and cost. - **Scheduled blast**: Returns a `scheduleId` and the schedule configuration.

Blast Responseobject

Scheduled Blast Responseobject

1	import { PinnacleClient } from "rcs-js";
2
3	async function main() {
4	const client = new PinnacleClient({
5	environment: "https://api.pinnacle.sh",
6	});
7	await client.messages.blast.rcs({
8	audienceId: "aud_abc123",
9	senders: [
10	"agent_pinnacle",
11	"agent_pinnacle2",
12	],
13	message: {
14	quickReplies: [
15	{
16	type: "trigger",
17	payload: "learn_more",
18	title: "Learn More",
19	},
20	],
21	text: "Hello from Pinnacle RCS!",
22	},
23	options: {
24	transcode: true,
25	validate: true,
26	},
27	});
28	}
29	main();

1	{
2	"blastId": "blast_1234567890",
3	"audienceId": "aud_abc123",
4	"totalRecipients": 250,
5	"totalMessages": 250,
6	"totalSegments": 250,
7	"totalCost": 8.75
8	}

Authentication

Request

Response

Errors