Deploy on WordPress
For WordPress sites, Hilal Chatbot offers a plugin that handles installation without you touching theme files. Install, link, and the widget appears on every page.
In this guide:
- Install the plugin
- Link to your Hilal Chatbot account
- Pick which chatbot to deploy
- Configure visibility
- Uninstall
Step 1: Install the plugin
In your WordPress admin:
- Go to Plugins → Add New.
- Search for Hilal Chatbot.
- Click Install Now, then Activate.
Alternatively, download the plugin ZIP from your Hilal Chatbot deployment page and upload via Plugins → Add New → Upload Plugin.
Step 2: Link to your Hilal Chatbot account
After activation, a Hilal Chatbot menu appears in your WordPress admin sidebar. Open it.
You’ll be prompted to enter the deployment token for the chatbot you want on this site. Get the token from:
Hilal Chatbot dashboard → your chatbot → Install → New deployment → WordPress → Copy token.
Paste the token in the WordPress plugin settings and click Connect.
Screenshot: The WordPress plugin showing a successful connection.
Step 3: Pick which chatbot to deploy
The token is bot-specific — once linked, that token’s bot is what powers your site. To switch bots, generate a new token in Hilal Chatbot for the other bot and re-link.
Step 4: Configure visibility
The plugin settings let you:
- Show on all pages — default.
- Show only on specific pages — pick by template (Home, Posts, Pages, Custom Post Types).
- Hide on specific URLs — exclude legal, login, checkout pages.
Step 5: Verify
Visit your WordPress site in an incognito window. The widget should appear in the corner you configured. Test a message.
Step 6: Uninstall
In WordPress admin:
- Plugins → Hilal Chatbot → Deactivate.
- Plugins → Hilal Chatbot → Delete (removes plugin files).
In Hilal Chatbot, optionally:
- Install → Deployments: revoke the WordPress deployment’s token to invalidate any cached widget loads.
Limitations
- Single-bot-per-site. Like the Shopify app, one site = one chatbot. For multi-bot setups, consider the Custom website embed.
- Multisite WordPress. Each subsite needs its own activation and deployment token.
Troubleshooting
- Plugin says “Token invalid.” The token may have been rotated in Hilal Chatbot. Generate a fresh one and re-paste.
- Widget appears but no replies. Token is valid but the bot may not be trained. Visit the chatbot in Hilal Chatbot and check status.
- Widget appears twice. Theme is loading the script directly and the plugin is also loading it. Pick one path.