# Byteonic Intake WordPress Plugin Guide

**Version 1.3.0**

This guide covers how to install, configure, and use the Byteonic Intake plugin to seamlessly deploy AI Chatbots and connect your WordPress forms (Gravity Forms, Contact Form 7, WPForms, Elementor, Divi) to the Byteonic Intake platform.

## 1. Installation

1.  **Download**: Log in to your Byteonic Intake Dashboard (`intake.byteoniclabs.com`).
2.  **Navigate**: Go to **Plugins & Integrations** in the sidebar.
3.  **Get Plugin**: Click the **Download** button on the WordPress Plugin card to get the `intake-forms.zip` file.
4.  **Upload to WordPress**:
    *   Go to your WordPress Admin.
    *   Navigate to **Plugins > Add New**.
    *   Click **Upload Plugin** and select the `.zip` file.
    *   Click **Install Now** and then **Activate**.

## 2. Configuration

1.  **Open Settings**:
    *   You will see a **Byteonic Intake** menu item in your WordPress admin sidebar.
    *   Alternatively, go to **Plugins**, find "Byteonic Intake," and click **Settings**.
2.  **Connect**:
    *   Enter your **API Key** from the Byteonic Dashboard (Settings > API Keys).
    *   Click **Save Settings**.
    *   If successful, you will see a "Connected successfully!" message and your organization details.

## 3. Deploying AI Chatbots

Deploying your trained AI Chatbot is incredibly simple.

1.  Navigate to the **Chatbots** tab inside the Byteonic Intake plugin hub.
2.  You will see a table listing all your trained chatbots from your Byteonic account.
3.  Click the **Activate** button next to the chatbot you want to deploy.
4.  The plugin will automatically whitelist your WordPress domain via API and securely inject the chatbot widget into your site's footer.
5.  Clear any site caching (if applicable), and your chatbot will be instantly live on the frontend.
6.  To switch chatbots, **Deactivate** the current one first, then **Activate** a different one.

## 4. Forms Integrations

The plugin integrates directly into your favorite form builders. You do not need to leave the builder to connect a form!

### Gravity Forms
1.  Edit any Form in Gravity Forms.
2.  Go to **Settings > Byteonic Intake**.
3.  Check **Enable Integration**.
4.  Select the **Target Form** from Byteonic.
5.  **Map Fields**: Select which Gravity Form field corresponds to each Byteonic field.
6.  Click **Save Settings**.

### Contact Form 7
1.  Edit a Contact Form.
2.  Click the **Byteonic Intake** tab (next to "Mail" and "Messages").
3.  Check **Enable Integration**.
4.  Select a **Target Form**.
5.  **Map Fields**: Match your CF7 "mail tags" (e.g., `[your-name]`) to the Byteonic fields.
6.  **Save** the Contact Form.

### WPForms
1.  Edit a form in the WPForms Builder.
2.  Go to **Settings > Byteonic Intake** in the left panel.
3.  Check **Enable Integration**.
4.  Select the **Target Form**.
5.  **Map Fields** using the dropdowns.
6.  **Save** the form.

### Elementor Forms (Coming Soon)
*   Look for "Actions After Submit" -> "Byteonic Intake".
*   A new "Byteonic Intake" section will appear for mapping.

### Divi Forms (Coming Soon)
*   Open the Contact Form Module settings.
*   Look for "Byteonic Intake" integration options.

## 5. Troubleshooting

*   **"Connection Failed"**: Check if your API Key is correct and has not been revoked.
*   **"Unknown API Error"**: Ensure the backend server is reachable.
*   **Chatbot not showing**: Ensure you have selected an active chatbot in the plugin dashboard and cleared any site caching plugins (like WP Rocket or LiteSpeed Cache). Verify that your API key has the correct domain permissions.
*   **Submissions not showing**: Check the form mapping and ensure "Enable Integration" is checked.
*   **Logs**: Gravity Forms users can check the Logging settings if enabled.

---
**Need Help?** Contact support at hello@intake.byteoniclabs.com.