Qiscus WhatsApp Integration

Connect your Qiscus Multichannel Chat account with Konektor. A customer WhatsApp message that carries a visitor code [K-...] or Click-to-WhatsApp ad data is automatically captured as a Lead. Messages from an existing lead are recorded on that lead, and Automation Rules run on Qiscus messages.

Why Integrate with Qiscus?

• Zero-Config Webhook: Konektor automatically registers the webhook URL to your Qiscus App.
• Real-time Sync: Incoming messages are recorded in the Leads dashboard instantly.
• Rich Media Support: Supports Text, Image, Video, Document, and Location messages.
• Secure: Automatic signature validation for data security (HMAC-SHA256).

Prerequisites

Before starting, ensure you have:

1. Qiscus Multichannel Account: With active WhatsApp Business API service.
2. Admin Access: To the Qiscus dashboard to view App ID and Secret Key.
3. Konektor Plan: the 14-day trial, or a Starter plan or higher.

Setup Guide

1. Get Qiscus Credentials

Login to your Qiscus Multichannel dashboard and find the following information in Settings > App Information:

• App ID: Unique application code (e.g., qiscus-app-123)
• Secret Key: Secret key for webhook validation
• Channel ID: Specific ID for your WhatsApp channel (usually a number)
• Server: the Qiscus dashboard address in the browser address bar. The address omnichannel.qiscus.com means that your account is in Indonesia. The address omnichannel-my.qiscus.com means that your account is in Malaysia.

2. Connect in Konektor Dashboard

1. Open Settings > Integrations.
2. Find the Qiscus card.
3. Click the Qiscus card under Available to connect.
4. Enter the credentials obtained in step 1:
   • App ID
   • Secret Key
   • Channel ID
   • Server (optional): enter omnichannel-my.qiscus.com if your account is in Malaysia. Leave it empty if your account is in Indonesia.
5. Click Connect.

3. Verify Status

Once connected, the integration status changes to Connected (green).

You can perform a simple test:

1. Send a WhatsApp message to your business number from a personal number.
2. Open the Leads menu in Konektor.
3. The new message should appear as a new Lead (or update an existing one) within seconds.

Automation Features

Once Qiscus integration is active, a message that carries a visitor code [K-...] or ad data becomes a Lead in Konektor. Other messages from an existing lead are recorded on that lead. A message from a new number with no code and no ad data does not create a lead. You can use Automation Rules to automate actions based on specific conditions.

Troubleshooting

Integration Failed to Connect

Error: "Invalid channelId: ... Qiscus API expects a valid positive integer." Solution: Ensure the Channel ID you entered is a pure number (no spaces or letters). Qiscus Channel IDs are usually integers.

Qiscus Account in Malaysia Does Not Connect

Symptom: The integration does not connect, but the App ID, Secret Key, and Channel ID are correct. Solution: Check the address of your Qiscus dashboard. If the address is omnichannel-my.qiscus.com, enter that address in the Server field, then save again. The Server field accepts only omnichannel.qiscus.com or omnichannel-my.qiscus.com.

Lead Not Appearing

Symptom: Message received in Qiscus but not showing in Konektor. Solution:

1. Ensure your Qiscus subscription is active.
2. Check if App ID and Secret Key are correct (sometimes swapped).
3. If the status is Pending or Has a problem, open the ⋮ menu on the Qiscus integration, then click Verify Connection to re-trigger webhook registration. If the status is Connected, open the ⋮ menu > Edit and check your credentials again.

Webhook Error

Symptom: Log error "Signature mismatch". Solution: This means the Secret Key entered in Konektor differs from the one in the Qiscus dashboard. Please update the Secret Key in Konektor.

Next Steps

• Learn WhatsApp Automation Rules
• Open Leads in the dashboard.