Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pokulabs.com/llms.txt

Use this file to discover all available pages before exploring further.

Pass a waitTime parameter which tells Poku how long to hold the HTTP request open and wait for a reply. The reply is returned directly in the response so your agent can continue without a webhook.

​
How it works

1

Poku sends the message

The message is delivered to the recipient via SMS, WhatsApp, or Slack.
2

The request stays open

The HTTP request is held open for waitTime seconds, listening for a reply.
3

Reply or timeout is returned

If the recipient replies within the window, the reply is returned in the HTTP response. If no reply is received, Poku returns a timeout message and your agent continues.
4

followUpTime keeps the channel open

After waitTime closes, followUpTime continues listening for late replies and delivers them to your configured webhook. Read more about Follow Up Time.

​
Voice Agent Use cases

Collect information during a call The voice agent texts the customer while on the call, waits for a reply, and reads back the confirmation.
Voice Agent: “I’ve just sent you a text where you can respond with your street address… I received your address as 123 Hardtospell St, thanks for texting it in.”
Share context & check availability before a transfer The agent confirms the human is available before initiating a transfer — avoiding dropped handoffs.
Voice Agent: “Customer on the line is asking about the status of their car repair, which I don’t have the details for. Are you free to take a call right now?”

​
Example

curl -X POST https://api.pokulabs.com/messages/sms \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Can you reply with your email address?",
    "to": "<customer-phone-number>",
    "waitTime": 60
  }'
Reply received: 
{ "response": "Human response: johnsmith@gmail.com" }

​
Channel notes

SMSWhatsAppSlack
Reply methodStandard text replyStandard WhatsApp replyMust reply directly in the Slack thread
Template when waitTime is setFree-form”Your AI agent is requesting your input. Message from agent: {{message}}. Please review and reply with your guidance. If no response is received within {{waitTime}} seconds, the request will be automatically closed.”Free-form
RequirementUsing your own number requires messaging approval (e.g., A2P10DLC)Poku WhatsApp or own number with Meta templateRecipient must join the Poku workspace or install Pokubot into their own workspace