Beware of lookalike sites. The official sites of Korea AI Telecom Inc. are katel.kr, katcloud.kr, zerocall.kr and aicallpay.com.Verify official channels
KAT CloudKOENLog in

Quickstart

5-minute quickstart

Get an API key, create a number, make calls and send messages, and receive results by webhook. Every example can be copied and used as-is. The base URL is https://studio-gateway.zerocall.kr.

01

Sign up and get an API key

Sign up in the console and issue an API key (the console is in Korean). Put the key as-is in the x-api-key header. Check that the key works with GET /auth-check.

The examples assume the key is stored in the environment variable KAT_API_KEY. Do not hard-code the key.

cURL
export KAT_API_KEY="your API key"

curl "https://studio-gateway.zerocall.kr/auth-check" \
  -H "x-api-key: $KAT_API_KEY"

MoreAuthenticationScope and permissions

02

Get a number

You get one 070 number when you sign up. You make and receive calls and messages with this number. Check the group ID, the number (phoneNumber) and the channel ID (channelId) with GET /group. You will use them in the next steps.

Need more numbers? On a paid plan, add them one at a time with POST /group/{groupId}/numbers. Check the added monthly fee first with GET /group/{groupId}/numbers/quote.

cURL
curl "https://studio-gateway.zerocall.kr/group" \
  -H "x-api-key: $KAT_API_KEY"

# Add one more number (paid plan; your monthly fee goes up)
curl "https://studio-gateway.zerocall.kr/group/$GROUP_ID/numbers/quote" \
  -H "x-api-key: $KAT_API_KEY"

curl -X POST "https://studio-gateway.zerocall.kr/group/$GROUP_ID/numbers" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Idempotency-Key: number-0001" \
  -H "Content-Type: application/json" \
  -d '{ "confirmMonthlyFee": true }'

MoreList groupsAdd numbers

03

Make a call

With AI outbound, an outbound agent (direction OUTBOUND) places the call for you. Attach an Idempotency-Key to every request. When you retry, send the same value so the call is not placed twice.

Once accepted, you get a requestId right away. Get the call result by querying it or through the AI_OUTBOUND webhook. The request body follows the input fields registered on the outbound agent. A real call is placed and charges apply.

cURL
# List outbound agents
curl "https://studio-gateway.zerocall.kr/group/$GROUP_ID/agent?direction=OUTBOUND" \
  -H "x-api-key: $KAT_API_KEY"

# Submit an outbound call (write call.json to match the agent's input fields)
curl -X POST "https://studio-gateway.zerocall.kr/group/$GROUP_ID/ai-outbound/calls" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @call.json

# Check status
curl "https://studio-gateway.zerocall.kr/group/$GROUP_ID/ai-outbound/calls/$REQUEST_ID" \
  -H "x-api-key: $KAT_API_KEY"

MoreAI outbound tools and REST mappingAI agents

04

Send a message

Open a chat room with the customer's number and send a message. If a room already exists for that number, its chat room ID is returned. SMS, LMS or MMS is chosen automatically based on length and attachments.

The chatId in the response matches data.chatId in the SEND_RESULT send-result webhook.

cURL
# Open a chat room → chat room ID
curl -X POST "https://studio-gateway.zerocall.kr/chat-room" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "channelId": 100, "phoneNumber": "01098765432" }'

# Send a message
curl -X POST "https://studio-gateway.zerocall.kr/chat" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chatRoomId": "CHAT_ROOM_ID", "content": "Your reservation is confirmed." }'

MoreCreate a chat roomSend a message

05

Receive webhooks

Register one URL per event. When a call ends, CALL_COMPLETED delivers the summary and the conversation. The URL must use https.

After registering, send a test notification with POST /webhook/{webhookId}/test. The test notification body includes "isTest": true.

cURL
curl -X POST "https://studio-gateway.zerocall.kr/webhook" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "eventType": "CALL_COMPLETED", "url": "https://my.app/kat/webhook" }'

# Send a test notification
curl -X POST "https://studio-gateway.zerocall.kr/webhook/$WEBHOOK_ID/test" \
  -H "x-api-key: $KAT_API_KEY"

MoreWebhook configurationWebhook event list

06

Verify signatures

Every notification carries the X-Webhook-Timestamp and X-Webhook-Signature headers. The signature is the hex digest of v1=HMAC-SHA256(secret, "<timestamp>.<raw body>").

Get the secret with GET /webhook/secret. Verify the body as raw bytes, before parsing it.

cURL
curl "https://studio-gateway.zerocall.kr/webhook/secret" \
  -H "x-api-key: $KAT_API_KEY"
# → { "secret": "whsec_…" }

# Compute the signature yourself (with the body saved in body.json)
printf '%s.' "$TIMESTAMP" | cat - body.json \
  | openssl dgst -sha256 -hmac "$KAT_WEBHOOK_SECRET" -hex

MoreNode / Python verification codeSignature verification

—

Next steps

  • To use it directly from an AI agent, connect the MCP server.
  • The events you can receive and the retry rules are in the webhook docs.
  • APIs other than SMS sending are available to groups on the Business plan or groups separately granted access. See Scope and permissions.
  • Error codes are listed under Error handling.

Get started

Give the AI you built today
a phone number

Use the Personal plan free for 7 days after you sign up. Get a number and take your first call.

Already have an account? Log in

The console (app.katcloud.kr) is in Korean.

  1. 01Create an account
  2. 02Get a phone number
  3. 03Connect your agent and take the first call