Kirimdev Integration

Connect your Kirimdev account with Konektor so a customer WhatsApp message that carries a visitor code [K-...] or Click-to-WhatsApp ad data becomes a Lead automatically. Messages from an existing lead are recorded on that lead. You can also send outbound WhatsApp messages (text & template) straight from Konektor.

About Kirimdev

Kirimdev (api.kirimdev.com) is a WhatsApp Cloud API platform for developers, with a clean REST API and built-in webhooks. Unlike other partners, Kirimdev works both ways:

Inbound — customer messages become leads automatically (HMAC-verified webhook).
Outbound — send text or template messages to customers, via Rules or a manual button on the lead page.

Automatic Webhook Registration

You only enter your API Key and Phone Number ID. Konektor registers the webhook with Kirimdev automatically and stores the signing secret for you — no need to copy a webhook URL or secret manually.

Prerequisites

Before you start, make sure you have:

An active Kirimdev account with a connected WhatsApp Business number.
An API Key in the kdv_live_… format.
The Phone Number ID of your WhatsApp account.

Where to find your credentials

API Key: Kirimdev Dashboard > Developers > API Keys. The key is shown only once when created — store it safely.
Phone Number ID: Kirimdev Dashboard > WhatsApp > Accounts. Copy the ID of the number you want to connect.

See the official docs at docs.kirimdev.com.

How to Integrate

1. Add the Integration in Konektor

Log in to the Konektor Dashboard.
Open Settings > Integrations.
Click the Kirimdev card under Available to connect.
Fill in the form:
- Integration name: e.g. "Kirimdev WhatsApp".
- API Key: paste your API key (kdv_live_…).
- Phone Number ID: paste your Phone Number ID.
Click Connect.

2. Confirm Active Status

After saving, Konektor automatically registers the webhook with Kirimdev and captures its signing secret.

On success, the integration status becomes Connected.
On failure (for example, a wrong API Key), the status becomes Has a problem with the reason. Fix the API Key and try again.

Keep Your API Key Secret

A Kirimdev API Key grants full access to your organization. Konektor stores it encrypted and never displays it again. Do not share the key; if it leaks, revoke it from the Kirimdev dashboard and issue a new one.

3. Test the Connection (Inbound)

Make sure the integration status is Connected.
Send a WhatsApp message from a customer number to your Kirimdev business number.
Open the Leads page to confirm the message arrived as a new lead or interaction.

Sending Outbound Messages

Kirimdev can send outbound WhatsApp messages in two ways.

A. Automatically via Rules

Create an automation: when a condition is met, send a WhatsApp message.

Open Conversations > Automation Rules and create a new rule.
For the Action, choose Send WhatsApp (Kirimdev).
Select the active Kirimdev integration.
Choose the message type:
- Text — type the message directly.
- Template — enter an approved template name and a language code (e.g. id_ID).
Save the rule. The message is sent automatically when the rule condition is met.

B. Manually from the Lead Page

Open the Leads page.
On a lead row that has a phone number, click the Send WhatsApp button (paper-airplane icon).
Pick the integration, choose the message type (text/template), write the message, then click Send.

Auto follow-up without hardcoding

For automatic notifications (for example, a confirmation when a lead status changes to "won"), use Rules with the Send WhatsApp (Kirimdev) action. This is more flexible and configurable per workspace.

Processed Events

Event	Action
`message.received`	Processed — inbound, creates/updates a lead and evaluates rules
`message.status`	Acknowledged — delivery status (delivered/read), no lead created
Native events (`X-Kirim-Source: kirim`)	Acknowledged — no lead created

Synced Data

Customer Information

Field	Description
`from`	Customer WhatsApp number
`profile.name`	Customer name (if available)

Message

Field	Description
`text` / caption	Message content
`type`	Message type (text, image, video, audio, document, location)
`phone_number_id`	Business WhatsApp number ID (channel)
`referral` / `ctwa_clid`	Click-to-WhatsApp ad metadata (if present)

Signature Verification

Kirimdev signs every webhook with HMAC-SHA256:

X-Kirim-Signature: t=<unix>,v1=<hex>

Konektor verifies this signature automatically using the signing secret captured during registration, including replay protection (5-minute tolerance) and secret rotation. No configuration is required.

Troubleshooting

Error status after Save

Make sure the API Key is correct and still active (not revoked in the Kirimdev dashboard).
Make sure the Phone Number ID matches your WhatsApp account.
Click Verify Connection on the integration row to retry the webhook registration.

Incoming Messages Don't Become Leads

Make sure the integration status is Connected.
Make sure the message comes from a customer (the message.received event), not just a status update.
Read the warning message on the integration row.

Outbound Messages Fail to Send

Make sure the lead has a valid phone number (international format, e.g. +628…).
For templates, make sure the template name is approved in Kirimdev and the language code is correct.
Make sure the selected integration is Connected.

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.