Skip to main content

Khaime Contact Form

Add a contact form to any WordPress page. Submissions appear in your Khaime dashboard, are sent to your email, and can trigger push notifications — the same pipeline used by forms on Khaime-hosted sites. They can also be added to campaign audiences.

Download the Plugin

khaime-contact-form.zip
Spam protection needs zero setup. Khaime provisions and manages it for your site automatically — no CAPTCHA account to create, no keys to paste, and no domains to configure. A honeypot, a minimum-fill-time check, and per-IP rate limiting run behind the scenes.

Setup

  1. Install and activate the plugin.
  2. Go to Khaime → Contact Form and paste your partner API key (from Settings → API in your dashboard). If Khaime Live Chat or Khaime Storefront is already configured on this site, skip this step — the key is shared automatically.
  3. Add the shortcode to any page:
The key determines the mode: pk_live_ keys deliver real submissions, while pk_sandbox_ keys run in test mode. There is no environment switch to configure.

Shortcode attributes

All attributes are optional. The email field is always shown and always required. Examples

Styling

The form inherits your theme’s fonts and colors. Form elements use stable khcf- classes — such as .khcf-form, .khcf-field, .khcf-submit, .khcf-notice--success, and .khcf-notice--error — so you can restyle them from Appearance → Customize → Additional CSS:
The class attribute adds your own class to the wrapper, letting two forms on one site look different.

How your data flows

Submissions travel from the visitor’s browser to your WordPress server, then from your server to Khaime. Your partner API key never reaches the browser, the spam-protection secrets never leave Khaime’s servers, and no sensitive information is exposed in your pages.

Local development

Point the plugin to a non-production backend by adding the following to wp-config.php:
The spam-protection check requires HTTPS: it works on https:// pages and on localhost, but fails to load on plain-HTTP custom hostnames. If you use Local by Flywheel, enable SSL for the site (Trust on the site’s Overview) and browse the https:// URL.

Troubleshooting

“Please complete the ‘Verify you are human’ check.” The check was either not completed or expired after sitting completed for a few minutes. Complete the check again and resubmit the form. The verification box isn’t appearing, but the settings screen says connected. The plugin caches its configuration for up to 12 hours. Select Test connection on the settings screen to refresh the configuration immediately. If your site uses page caching, purge the cache as well. Submissions are rejected with a spam-protection error even after completing the check. Select Test connection, reload the page to get a fresh check, and try again. Completed checks are single-use, so a retried submission always needs a new one.

Still stuck?

If you’ve followed the steps above and still need help, reach out — include your site URL and whether Test connection succeeds:

Email support

Community

Ask in the Khaime Discord