kirim.chat Integration

Connect your kirim.chat account with Konektor so that a customer message that carries a visitor code [K-...] or Click-to-WhatsApp ad data is automatically saved as a Lead in Konektor. Messages from an existing lead are recorded on that lead. Automation Rules run on kirim.chat messages.

About kirim.chat

kirim.chat is a multi-channel messaging platform supporting:

WhatsApp Business API (WABA) - Official API from Meta
COEX - WhatsApp without business verification
Instagram - Direct Message
Messenger - Facebook Messenger

Affordable Pricing

Starting from IDR 25,000/month with WABA & COEX support. Sign up for kirim.chat

Prerequisites

Before starting, make sure you have:

An active kirim.chat account.

Don't have a kirim.chat account?

How to Integrate

1. Create Integration in Konektor

Login to Konektor Dashboard.
Open Settings > Integrations.
Click the kirim.chat card under Available to connect.
Enter integration name (e.g., "kirim.chat WhatsApp").
Do NOT fill in Webhook Secret yet - leave it empty.
Click Connect.

Important: Integration Order

kirim.chat requires a Webhook URL before you can obtain a Webhook Secret. Follow the steps below in order.

2. Copy Webhook URL

After creating the integration, an instruction popup will appear with the Webhook URL:

Click the Copy button on the displayed URL.

The URL format:

https://[domain]/api/webhooks/partners/kirimchat/[integrationId]

You can also view the URL anytime by clicking the View Webhook URL button (link icon) on the integration row.

3. Configure Webhook in kirim.chat

Login to kirim.chat dashboard.
Go to Developers > Webhooks.
Click Create Webhook.
Fill in the form:
- Name: Konektor
- URL: Paste webhook URL from Konektor
- Permissions: Check all available permissions
- Events: Check all (Message Received, Sent, Delivered, Read, Failed)
- Channels: Select WhatsApp
Click Create Webhook.
Copy the Webhook Secret displayed after creating the webhook.

4. Enter Webhook Secret in Konektor

Return to Konektor Dashboard.
Open the ⋮ menu on the kirim.chat integration, then select Set secret.
Enter Webhook Secret from kirim.chat dashboard.
Click Update.

5. Test the Connection

Make sure the kirim.chat integration is Connected after saving the Webhook Secret.
Send a test message from WhatsApp to your kirim.chat number.
Open the Leads page to confirm the message appears as a lead/interaction.
If the status is still Pending, open the ⋮ menu on the integration and click Set secret.

Events Processed

Event	Action
`message.received`	Processed - inbound, creates/updates lead, and evaluates rules
`message.sent`	Processed - outbound, updates lead interaction/rules (does not create new lead)
`message.delivered`	Processed - outbound, treated like `message.sent` for compatibility
`message.read`	Ignored (`not_a_message`)
`message.failed`	Ignored (`not_a_message`)

Leads, Rules, and Old Chats

Leads: A lead is created from a message that carries a visitor code [K-...] or Click-to-WhatsApp ad data. Other messages from an existing lead are recorded on that lead.
Automation Rules: Rules run on kirim.chat messages, both customer messages and outgoing team messages. Read Automation Rules.
Old chats: Konektor receives only new messages after the webhook is active. Old chats in kirim.chat are not imported.
No Session needed: With an active kirim.chat integration, you do not need to connect the same number through a QR session.

Click-to-WhatsApp (CTWA) Ads

kirim.chat passes on the ad data from a Click-to-WhatsApp ad chat, including ctwa_clid. Konektor uses ctwa_clid to send conversions to Meta, not fbclid. Set up CTWA with the Click-to-WhatsApp Ads from Zero guide.

Data Synchronized

Customer Information

Field	Description
`customer_phone`	Customer phone number
`customer_name`	Customer name (if available)
`customer_id`	Customer ID in kirim.chat

Message

Field	Description
`content`	Message content
`message_type`	Message type (text, image, video, audio, document, location)
`channel`	Channel (whatsapp, instagram, messenger)
`timestamp`	Message timestamp

Signature Verification

kirim.chat uses HMAC-SHA256 to verify webhooks:

X-KirimChat-Signature: sha256=xxxxxx

Konektor will verify this signature using the Webhook Secret you entered to ensure the webhook is from kirim.chat.

Troubleshooting

Invalid Signature

If you get Invalid signature error:

Make sure Webhook Secret in Konektor matches the one in kirim.chat dashboard.
If unsure, create a new webhook in kirim.chat and update the secret in Konektor.

Messages Not Coming Through

If messages are not reaching Konektor:

Make sure webhook URL is correct in kirim.chat dashboard.
Make sure selected channel is WhatsApp.
Make sure the Webhook Secret has been saved on the integration card.
Read the warning message on the integration row.

Last Sync: Never

Last sync: Never on the integration row means no message from kirim.chat has reached Konektor and been processed.

Send one test message from WhatsApp to your kirim.chat number.
Make sure the webhook in kirim.chat uses the URL from Konektor and the WhatsApp channel.
Make sure the Webhook Secret is saved on the integration card.

Old chats in kirim.chat are not sent again. Only new messages appear.

Error Status

If status changes to Has a problem:

Update Webhook Secret with a new one.
Save the integration again, then send a WhatsApp test message.

Next Steps

Create Automation Rules
Open Leads in the dashboard.

Need More Help?

Our team is ready to help you maximize ad tracking and business attribution.

support@konektor.idYouTube

Wulan answers your questions and sends tutorial videos. Session scheduling is available through Wulan if you still need it.