Connect HaloAI to Konektor

A webhook is a private URL that HaloAI uses to send message and ad referral data to Konektor. Konektor uses that data to record new contacts as leads. To send Click-to-WhatsApp (CTWA) conversions to Meta, complete the separate Meta setup after the webhook is working.

Before you begin

Prepare the following:

• owner or admin access to your Konektor workspace;
• access to the webhook settings in HaloAI;
• one WhatsApp number that you can use to send a test message.

For CTWA conversion tracking, you also need:

• the same business number connected through HaloAI in Konektor;
• a Meta account with access to the WhatsApp Business Account (WABA);
• the WABA ID for that business number.

A WABA is the Meta business account that contains your WhatsApp number. When you connect Meta, Konektor asks Meta to select the CTWA dataset already associated with the WABA or create one if needed. You do not need to find or enter a Dataset ID.

Connect the HaloAI webhook

1. Create the HaloAI integration

1. Sign in to Konektor.
2. Open Settings > Integrations.
3. Find the HaloAI card.
4. Click the Halo AI card under Available to connect.
5. Enter an Integration Name, such as HaloAI - Demo Store.
6. Select Connect.

Konektor does not ask for a HaloAI API key at this stage.

2. Copy the webhook URL

1. Find the HaloAI integration card that you just created.
2. Select View Webhook URL.
3. Copy the displayed URL.

This URL is unique to your workspace and must remain private. Do not include it in documentation, public support tickets, or messages that other people can read.

3. Add the webhook in HaloAI

1. Open the webhook settings in your HaloAI account. The menu name may differ between HaloAI interfaces.
2. Add a webhook for incoming WhatsApp messages.
3. Paste the URL from Konektor.
4. Save the changes.

Check that leads arrive

1. Send a new message from your test number to the business WhatsApp number.
2. Open Leads in Konektor.
3. Confirm that the contact from the test message appears as a lead.
4. Return to the HaloAI integration card and check Last sync.

The webhook is working when the new lead appears and Last sync changes. The Connected status on the card only confirms that the integration configuration exists; it does not prove that HaloAI has delivered a message.

Enable CTWA conversion tracking

Skip this section if you do not run Click-to-WhatsApp ads. The HaloAI webhook can include the ad click ID, but it does not give Konektor permission to send events to Meta. Konektor receives that permission when you connect the WABA.

1. Confirm that your Facebook account is admin of the business that owns the WABA for the HaloAI number.
2. After the HaloAI connection succeeds, click Set up CTWA for this number. Or open Connection > Numbers & CTWA, then click Use a connected number.
3. Select Set up CTWA on that number. Select Manage CTWA if the number was previously connected.
4. Enter the WhatsApp Business Account ID in the CTWA panel.
5. Click Log in with Meta. Meta login is the main method.
6. In the Meta dialog, tick the business and the WhatsApp account of this number.

Follow the Meta CTWA guide for the complete steps, disconnection, and replacing the connection.

Test one CTWA conversion

1. Open the CTWA ad as a prospective customer, then send a new message.
2. Confirm that the message creates a new lead in Konektor.
3. Record one conversion for that lead.
4. Open Conversions > Delivery log and check the delivery channel and status.

The Meta CTWA badge identifies the dedicated CTWA channel. The badge is not acceptance proof. A Sent status on a Meta CTWA row proves that Meta received the dedicated event. CTWA backup identifies the backup route through Meta CAPI. These results do not prove that Ads Manager reported or attributed the conversion.

Troubleshooting

Leads do not arrive

1. Make sure the webhook URL in HaloAI matches the URL shown under View Webhook URL.
2. Make sure the HaloAI webhook is active for incoming messages.
3. Send a new message; an older message will not start a new test.
4. Check whether Last sync changes and whether a lead appears.

If neither changes, contact Support with the test time and integration name. Do not send the complete webhook URL.

The conversion shows CTWA backup or Skipped

Konektor uses the backup route through Meta CAPI when the dedicated CTWA connection is not ready. An older entry can remain Skipped if Konektor processed it before the backup route became available. A test without a Meta ad click also shows Skipped because of Strict mode. This is normal.

Confirm that the lead came from a new message sent through a CTWA ad. Open Connection > Numbers & CTWA > Manage CTWA, then select Check connection.

After you correct the setup, create one new conversion. Resend uses these rules:

• A CTWA backup row with Sent or Failed status can be eligible.
• A Meta CTWA row with a final Failed status can be eligible.
• A row with Queued status is not eligible.
• A Meta CTWA row with Sent status blocks a duplicate dedicated resend for the same event and dataset.
• A regular Meta CAPI row does not offer CTWA resend.

The WABA cannot connect to the dataset

If Konektor reports that the WABA or dataset is unavailable, do not keep selecting the button. Check that:

• your Meta account can access the WABA;
• the WABA ID belongs to the correct business account;
• the Facebook account you log in with has access to that WABA.

If all three are correct, contact Support. Include the number name, attempt time, and safe message shown. Do not send a token, password, complete WABA ID, Dataset ID, or webhook URL.

The number does not show in Numbers & CTWA

Open Connection > Numbers & CTWA, then click Use a connected number. If the HaloAI number is not in the list, contact Support so the number and WABA ownership can be checked. Do not create a QR session just to bypass this step.

HaloAI or another partner manages the WABA

Using a partner does not replace Meta authorization. Ask the partner or Business Portfolio administrator to grant the required access to your Meta account and confirm the WABA ID. Meta selects or creates the CTWA dataset when you connect the account. If they cannot grant access, ask the partner to coordinate with Konektor Support before you try to connect the WABA.

Related guides

• Click-to-WhatsApp conversion tracking
• Set up Meta CTWA with Meta login
• Meta Conversions API
• WhatsApp automation