INCEPTION

Inception Whatsapp API

Send Whatsapp Messages via REST API to your client's phone number.

First Step

Login or Register

Click Login on the navbar. Enter your credentials or create an account. You will be redirected to your dashboard.

Whatsapp Login
Login Page

Your dashboard will show the monthly rate of sent messages via Inception Whatsapp API. Development environment is shown by default.

Whatsapp API Dashboard
Your Dashboard

Second Step

Add your number to send messages

Click My Numbers on the sidebar. You will be redirected to your registered numbers list.

Whatsapp Numbers Dashboard
Whatsapp Numbers List

Click on Add a Number button on the top right. Enter your number and scan the barcode with your Whatsapp to connect.

Add Whatsapp Number
Add Whatsapp Number
Scan Number
Scan barcode with your Whatsapp

As of now, you can only enter Indonesian number (+62) and the barcode will auto close in 30 seconds. Your number will show on the list after successful syncing.

Third Step

Send messages

You can now send messages via REST API with POST method. Curl example:

curl --location 'https://api.inception.id/whatsapp/messages' --header 'Content-Type: application/json' --data '{ "whatsappPhoneId": "29c3d8b2-...", // Your phone ID from registered number list (format: UUID) "whatsappPhoneNumber": "821...", // Your registered phone number, do not put 0 prefix "targetPhoneNumber": "821...", // Your client/target phone number, do not put 0 prefix "message": "Hello World!", // Message you want to send "environment": "DEVELOPMENT" // Environment: DEVELOPMENT or PRODUCTION, must be uppercase }'

Example response:

{ "status": 201, // HTTP Status "data": { "messageId": "e384b429-...", // Unique ID of each message (format: UUID) "whatsappPhoneId": "63d35f18-...", // Your phone ID from registered number list (format: UUID) "whatsappPhoneNumber": "821...", // Your registered phone number "targetPhoneNumber": "821...", // Your client/target phone number "message": "Hello World!", // Message you want to send "environment": "DEVELOPMENT" // Environment: DEVELOPMENT or PRODUCTION }, "message": "" // Will show if there's any error }

Response Status:

  • 201: Created and your message is sent
  • 400: Something is wrong with your parameter, will show the error on the message.
  • 429: You reached your monthly rate limit. (Only for DEVELOPMENT environment)
  • 500: Blame the error on our side

* As of now, you can only send messages to Indonesian number (+62)

FAQ