kirim.chat Integration
Connect your kirim.chat account with Konektor to automatically save incoming customer messages as Leads in your Konektor database.
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
Prerequisites
Before starting, make sure you have:
- An active kirim.chat account.
Don't have a kirim.chat account?
Sign up for kirim.chat here: Sign up for kirim.chat
How to Integrate
1. Create Integration in Konektor
- Login to Konektor Dashboard.
- Go to Integrations > Partner Integrations.
- Click + Add Integration and select kirim.chat.
- Enter integration name (e.g., "kirim.chat WhatsApp").
- Do NOT fill in Webhook Secret yet - leave it empty.
- Click Save.
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 button (link icon) on the integration card.
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
- Name:
- Click Create Webhook.
- Copy the Webhook Secret displayed after creating the webhook.
4. Enter Webhook Secret in Konektor
- Return to Konektor Dashboard.
- Click the edit icon (pencil) on kirim.chat integration.
- Enter Webhook Secret from kirim.chat dashboard.
- Click Save.
5. Test the Connection
- Make sure the kirim.chat integration is Active 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 integration card and click Enter 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) |
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.
- Check error log in the integration card.
Error Status
If status changes to Error:
- Update Webhook Secret with a new one.
- Save the integration again, then send a WhatsApp test message.
Next Steps
- Create Automation Rules
- Open Leads Data in the dashboard.
Need More Help?
Our team is ready to help you maximize ad tracking and business attribution.
© 2026 Konektor. All rights reserved.