Kirimdev Integration

Connect your Kirimdev account with Konektor so every incoming WhatsApp message becomes a Lead automatically, and 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.

Prerequisites

Before you start, make sure you have:

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

How to Integrate

1. Add the Integration in Konektor

1. Log in to the Konektor Dashboard.
2. Open Integrations > Partner Integrations.
3. Click + Add Integration and select Kirimdev.
4. 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.
5. Click Save.

2. Confirm Active Status

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

• On success, the integration status becomes Active.
• On failure (for example, a wrong API Key), the status becomes Error with the reason. Fix the API Key and try again.

3. Test the Connection (Inbound)

1. Make sure the integration status is Active.
2. Send a WhatsApp message from a customer number to your Kirimdev business number.
3. 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.

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

B. Manually from the Lead Page

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

Processed Events

Synced Data

Customer Information

Message

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

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

Incoming Messages Don't Become Leads

1. Make sure the integration status is Active.
2. Make sure the message comes from a customer (the message.received event), not just a status update.
3. Check lastError on the integration card.

Outbound Messages Fail to Send

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

Next Steps

• Create Automation Rules
• Open Leads Data in the dashboard.