Skip to main content

​
Outbound SMS

When you ask your agent to send a text, it drafts the message, confirms with you before sending, and reports back on delivery. You can also ask your agent to text multiple people at once. The agent will send each message individually and confirm delivery for each recipient.
Outbound SMS is intended for conversational use only — not marketing or bulk messaging. Poku will automatically shut down accounts detected sending spam or promotional texts.
1

Draft and confirm

The agent drafts the message based on what you want to say and shows it to you before sending:
Here’s the draft: “[message body]” Sending to [number] — good to go?
It waits for your confirmation before proceeding.
2

Send the text

Once confirmed, the agent hits the Poku SMS endpoint with your API key, the message, and the destination number. The to number is always formatted in E.164 (e.g. +19172577580).
3

Confirm delivery

The agent reports back: “Done — your text was sent to [number].” On any error, it reports the raw message and does not retry.

​
API reference

POST https://api.pokulabs.com/phone/sms

Authorization: Bearer $POKU_API_KEY
ParameterTypeRequiredDescription
messagestringYesThe body of the text message.
tostringYesDestination phone number in E.164 format (e.g. +15551234567).
Sample payload 
{
  "message": "Hey John! Just wanted to check if you're still on for coffee with Dan at 2 pm tomorrow.",
  "to": "+19172577580"
}

​
Inbound SMS

When someone texts your reserved number, Poku forwards the message to your agent via webhook. You’ll receive a real-time notification through whichever channel you’ve configured (e.g. Telegram, Slack) and can review and respond from there.
Inbound SMS requires a webhook to be set up. See the Webhook page to get started.