{"id":17454079,"url":"https://github.com/daley-mottley/customer-support-bot","last_synced_at":"2025-04-19T15:37:16.155Z","repository":{"id":258729048,"uuid":"854239016","full_name":"daley-mottley/customer-support-bot","owner":"daley-mottley","description":"Customer Support Bot is a WordPress plugin that enables businesses to automate customer support using AI technology.  #hacktoberfest","archived":false,"fork":false,"pushed_at":"2025-03-30T00:35:20.000Z","size":523,"stargazers_count":12,"open_issues_count":1,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-16T09:22:50.308Z","etag":null,"topics":["ai","chatbot","chatgpt","hacktoberfest","open-source","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://tinyurl.com/customer-support-chatbot","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daley-mottley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-08T18:32:32.000Z","updated_at":"2025-04-10T18:22:57.000Z","dependencies_parsed_at":"2024-12-23T22:24:33.582Z","dependency_job_id":"562060c2-2b7a-44f3-8a88-0529ebb8b736","html_url":"https://github.com/daley-mottley/customer-support-bot","commit_stats":{"total_commits":385,"total_committers":5,"mean_commits":77.0,"dds":"0.025974025974025983","last_synced_commit":"521d233f26815bd72479d323a6520fad9da0bd0e"},"previous_names":["dmotts/customer-support-bot","daley-mottley/customer-support-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daley-mottley%2Fcustomer-support-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daley-mottley%2Fcustomer-support-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daley-mottley%2Fcustomer-support-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daley-mottley%2Fcustomer-support-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daley-mottley","download_url":"https://codeload.github.com/daley-mottley/customer-support-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249728355,"owners_count":21316867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatbot","chatgpt","hacktoberfest","open-source","wordpress","wordpress-plugin"],"created_at":"2024-10-18T01:04:10.447Z","updated_at":"2025-04-19T15:37:16.103Z","avatar_url":"https://github.com/daley-mottley.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\n\u003cspan align=\"center\"\u003e\n       \u003cimg src=\"https://github.com/daley-mottley/customer-support-bot/blob/main/assets/images/logo-white.png\" alt=\"logo\" height=\"150\" width=\"150\" /\u003e\n\u003c/span\u003e\n\u003cbr\u003e\n☀️ Customer Support Bot ☀️\n\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/daley-mottley/customer-support-bot/issues/new?assignees=\u0026labels=enhancement\u0026projects=\u0026template=feature_request.yml\u0026title=%5BFeature+Request%5D+\"\u003eRequest Feature\u003c/a\u003e\n     ·\n    \u003ca href=\"https://shorturl.at/AZvWp\" target=\"blank\"\u003eView Demo \u003c/a\u003e \n    ·\n    \u003ca href=\"https://github.com/daley-mottley/customer-support-bot/issues/new?assignees=\u0026labels=bug\u0026projects=\u0026template=bug_report.yml\u0026title=%5BBug%5D+\"\u003eReport Bug\u003c/a\u003e\n\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/daley-mottley/customer-support-bot/blob/main/CONTRIBUTING.md\"\u003eContributing Guidelines \u0026 Code of Conduct\u003c/a\u003e\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cp\u003e\n\n[![Open Source Love svg1](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)\n![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)\n![GitHub forks](https://img.shields.io/github/forks/daley-mottley/customer-support-bot)\n![GitHub Repo stars](https://img.shields.io/github/stars/daley-mottley/customer-support-bot)\n![GitHub contributors](https://img.shields.io/github/contributors/daley-mottley/customer-support-bot)\n![GitHub last commit](https://img.shields.io/github/last-commit/daley-mottley/customer-support-bot)\n![GitHub repo size](https://img.shields.io/github/repo-size/daley-mottley/customer-support-bot)\n![GitHub total lines](https://sloc.xyz/github/daley-mottley/customer-support-bot)\n![Github](https://img.shields.io/github/license/daley-mottley/customer-support-bot)\n![GitHub issues](https://img.shields.io/github/issues/daley-mottley/customer-support-bot)\n![GitHub closed issues](https://img.shields.io/github/issues-closed-raw/daley-mottley/customer-support-bot)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/daley-mottley/customer-support-bot)\n![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/daley-mottley/customer-support-bot)\n\u003c/p\u003e\n\u003c/div\u003e\n\n \u003chr\u003e\n\n![Customer Support Bot Screenshot](https://res.cloudinary.com/dzpafdvkm/image/upload/v1726858049/Portfolio/customer-support-bot-screenshot.png)\n\n\n## Project Overview 📑\n\n**Customer Support Bot** is a WordPress plugin that enables businesses to automate customer support using AI technology, now powered by the **Google Gemini API**. The bot offers features like knowledge base searches (basic conversational ability), appointment scheduling checks, and appointment booking capabilities to enhance user experience and reduce the workload on customer support agents.\n\n## Table of Contents📋\n\n- [Features](#features-)\n- [Technologies Used](#technologies-used-)\n- [Installation](#installation-️)\n  - [Download from GitHub](#1-download-from-github)\n  - [Clone the Repository](#2-clone-the-repository)\n- [Configuration](#configuration-) \n- [Help Wanted](#help-wanted-)\n- [Report A Bug](#report-a-bug-)\n- [Contributions](#contributions)\n- [Contributors](#contributors)\n- [Let's Stay Connected](#lets-stay-connected)\n\n## Features 📝\n\u003cul style=\"list-style-type:none;padding-left:0;\"\u003e\n\u003cli\u003e📌 \u003cstrong\u003eConversational AI:\u003c/strong\u003e Engage users with responses powered by Google Gemini.\u003c/li\u003e\n\u003cli\u003e📌 \u003cstrong\u003eAppointment Availability Checks:\u003c/strong\u003e Check appointment slots via webhook integration.\u003c/li\u003e\n\u003cli\u003e📌 \u003cstrong\u003eAppointment Scheduling:\u003c/strong\u003e Allow users to book appointments through the bot via webhook integration.\u003c/li\u003e\n\u003cli\u003e📌 \u003cstrong\u003eCustomization Settings:\u003c/strong\u003e Customize bot appearance (colors), avatar, name, and greeting in the WordPress admin panel.\u003c/li\u003e\n\u003c/ul\u003e\n\n## Technologies Used 📚\n\n- [WordPress](https://wordpress.org/) – CMS platform where the plugin is installed and activated.\n- [PHP](https://www.php.net/) – Server-side language for API interactions and WordPress plugin development.\n- [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript) – Frontend logic for chatbot interaction.\n- [Axios](https://axios-http.com/docs/intro) – HTTP client used on the frontend for AJAX requests.\n- [Bootstrap](https://getbootstrap.com/) – CSS framework for styling the admin settings page.\n- [Google Gemini API](https://ai.google.dev/) – Integrates AI capabilities for advanced NLP features and function calling. \n\n## Installation ⚙️\n\nYou can install the **Customer Support Bot** plugin in two ways:\n\n### 1. Download from GitHub\n\n- Go to the [GitHub repository](https://github.com/daley-mottley/customer-support-bot) and download the repository as a ZIP file (e.g., from the \"Code\" button -\u003e \"Download ZIP\").\n- Navigate to your WordPress admin dashboard.\n- Go to **Plugins \u003e Add New \u003e Upload Plugin**.\n- Choose the downloaded ZIP file and click **Install Now**.\n- After installation, click **Activate Plugin**.\n\n### 2. Clone the Repository\n\nAlternatively, you can clone the repository using Git if you have command-line access to your server:\n\n1. Navigate to your WordPress plugin directory (usually located at `wp-content/plugins/`).\n2. Clone the repository: `git clone https://github.com/daley-mottley/customer-support-bot.git`\n3. Log in to your WordPress admin dashboard.\n4. Go to **Plugins \u003e Installed Plugins**.\n5. Find **Customer Support Bot** in the list and click **Activate**.\n\n## Configuration ⚙️ \n\nAfter activating the plugin, navigate to **Settings -\u003e Chat Widget** in your WordPress admin dashboard. You **must** configure the following for the bot to work:\n\n-   **Gemini API Key:** Enter your API key obtained from [Google AI Studio](https://aistudio.google.com/app/apikey). This is required.\n-   **Assistant Name:** Customize the name displayed in the chat header (e.g., \"Support Bot\", \"Booking Assistant\").\n-   **Avatar Image:** Upload a custom avatar image for the bot.\n-   **Bot Greeting:** Set the initial message the bot displays when opened by a user.\n-   **Theme \u0026 Text Colors:** Customize the primary background color and text color of the chat widget.\n-   **Webhook URLs:** If you want to use appointment checking or booking, enter the full webhook URLs provided by your automation service (like Make.com or Zapier) for the \"Check Availability\" and \"Book Appointment\" functions.\n\n**Save your settings** after making changes.\n\n## Help Wanted 🪧\n\nWe are looking for contributors to help add more features! Some ideas include:\n\n- [ ] **Conversation History:** Implement frontend and backend logic to remember the context of the current chat session.\n- [ ] **Knowledge Base Integration:** Allow the bot to search WordPress posts/pages or a custom knowledge base to answer questions.\n- [ ] **Basic Troubleshooting**: Provide users with automated solutions for common problems based on predefined flows.\n- [ ] **Ticket Categorization**: Automatically sort incoming support tickets (if integrated with a helpdesk).\n- [ ] **Status Updates**: Notify users of ticket status and resolution progress (if integrated).\n- [ ] **Password Resets**: Allow users to initiate password resets through the bot (requires integration).\n- [ ] **Billing Inquiries**: Help users resolve common billing-related questions.\n- [ ] **Product Information**: Provide detailed information on products/services.\n- [ ] **Return/Refund Processing**: Guide users through the process of returns or refunds (requires integration).\n- [ ] **Escalation Management**: Option to escalate unresolved issues to human support agents (e.g., via email or helpdesk ticket).\n- [ ] **Satisfaction Surveys**: Gather feedback from users about their support experience.\n- [ ] **Multi-language Support**: Offer support in multiple languages.\n\n## Report A Bug 🪰\n\nIf you encounter any issues or have questions, feel free to [open an issue](https://github.com/daley-mottley/customer-support-bot/issues/new?assignees=\u0026labels=bug\u0026projects=\u0026template=bug_report.yml\u0026title=%5BBug%5D+) or reach out to the maintainers. Please provide as much detail as possible, including steps to reproduce the bug.\n\n\u003ca name=\"contributions\"\u003e\u003c/a\u003e\n## Contributions 🧑‍🔧👷‍♀️🏗️🏢\n\nContributions are welcome! It only takes five (5) steps!\n\nTo contribute:\n\n1) Fork the repository.\n2) Create a new branch for your feature or bug fix: `git checkout -b my-feature-branch`.\n3) Make your changes and commit them with clear messages: `git commit -m 'Add some feature'`.\n4) Push your changes to your forked repository: `git push origin my-feature-branch`.\n5) Open a pull request against the `main` branch of the original repository.\n\n\u003cp align=\"center\" \u003e\u003cstrong\u003e\u003cem\u003ePlease read our \u003ca href=\"https://github.com/daley-mottley/customer-support-bot/blob/main/CONTRIBUTING.md\" \u003eContributing Guidelines\u003c/a\u003e to get started!\u003c/em\u003e\u003c/strong\u003e 🚀\u003c/p\u003e\n\n\u003ca name=\"contributors\"\u003e\u003c/a\u003e\n\u003ch2 align=\"center\"\u003eSay 'Hi' To Our Contributors!\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/daley-mottley\"\u003e\n    \u003cimg src=\"https://github.com/daley-mottley.png\" width=\"100\" height=\"100\" style=\"border-radius: 50%;\" alt=\"daley-mottley\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/mostafahanafi\"\u003e\n    \u003cimg src=\"https://github.com/mostafahanafi.png\" width=\"100\" height=\"100\" style=\"border-radius: 50%;\" alt=\"mostafahanafi\"/\u003e\n  \u003c/a\u003e\n   \u003ca href=\"https://github.com/AmanWebDev2\"\u003e\n    \u003cimg src=\"https://github.com/AmanWebDev2.png\" width=\"100\" height=\"100\" style=\"border-radius: 50%;\" alt=\"AmanWebDev2\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/kliu57\"\u003e\n    \u003cimg src=\"https://github.com/kliu57.png\" width=\"100\" height=\"100\" style=\"border-radius: 50%;\" alt=\"kliu57\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/Shivakarthikeya23\"\u003e\n    \u003cimg src=\"https://github.com/Shivakarthikeya23.png\" width=\"100\" height=\"100\" style=\"border-radius: 50%;\" alt=\"Shivakarthikeya23\"/\u003e\n  \u003c/a\u003e\n\n\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e🫶 \u003cem\u003eThank you for your support! \u003c/em\u003e🙌 \u003c/p\u003e\n\n\u003chr\u003e\n\n\u003ca name=\"lets-stay-connected\"\u003e\u003c/a\u003e\n\u003ch2 align=\"center\"\u003e 🌎 Let's Stay Connected!🫸🫷 \u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e If you like this project and would like to see more features or show your support.\u003c/p\u003e\n\u003cp align=\"center\"\u003e Feel free to reach out to the developers and give this project a ⭐!\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaley-mottley%2Fcustomer-support-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaley-mottley%2Fcustomer-support-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaley-mottley%2Fcustomer-support-bot/lists"}