แท่น
หน้าตา
สตูดิโอตัวแทน
สร้างและปรับแต่งตัวแทนของคุณอย่างรวดเร็ว
เครื่องยนต์อัตโนมัติ
ใช้ LLMs เพื่อเป็นแนวทางการสนทนาและงานต่างๆ
ฐานความรู้
ฝึกบอทของคุณด้วยแหล่งความรู้ที่กําหนดเอง
ตาราง
จัดเก็บและจัดการข้อมูลการสนทนา
ช่อง
Whatsapp ตราสัญลักษณ์
WhatsApp
Instagram ตราสัญลักษณ์
Instagram
เฟสบุ๊ค Messenger โลโก้
Messenger
Slack โลโก้
Slack
ทุกช่องทาง
การบูรณาการ
โลโก้ฮับสปอต
ฮับสปอต
Notion โลโก้
Notion
โลโก้ Jira
จิรา
Calendly โลโก้
Calendly
การบูรณาการทั้งหมด
LLM ผู้ให้บริการ
OpenAI โลโก้
OpenAI
Anthropic โลโก้
Anthropic
Groq โลโก้
Groq
โลโก้ HuggingFace
Hugging Face
ทั้งหมด LLMs
โซ ลู ชั่น
เพื่อ
องค์กร
ทำให้เวิร์กโฟลว์การผลิตที่สำคัญต่อภารกิจเป็นอัตโนมัติ
เอเจนซี่
ให้บริการตัวแทนที่มีความซับซ้อน
นักพัฒนา
สำรวจ API ที่แข็งแกร่งสำหรับการพัฒนาตัวแทน
เรื่องราวของลูกค้า
ค้นพบจากลูกค้าที่ประสบความสําเร็จว่า Botpress กําลังเปลี่ยนแปลงธุรกิจทั่วโลก
ตามอุตสาหกรรม
อีคอมเมิร์ซ
การศึกษา
การเงิน
การต้อนรับ
ทุกอุตสาหกรรม
ตามแผนก
ขาย
วิศวกรรม
ผลิตภัณฑ์
ไอทีเอสเอ็ม
ทุกแผนก
ตามกรณีการใช้งาน
ผู้ช่วยช้อปปิ้ง
การสร้างโอกาสในการขาย
ประสบการณ์ของพนักงาน
การจัดการตั๋ว
กรณีการใช้งานทั้งหมด
ทรัพยากร
จำเป็น
Academy
เรียนรู้การสร้างผ่านหลักสูตรที่คัดสรรมา
ห้องสมุด
ทรัพยากรเพื่อเพิ่มประสิทธิภาพเวิร์กโฟลว์ AI ของคุณ
บล็อก
ข้อมูลเชิงลึกและการอัพเดทเกี่ยวกับ Botpress และตัวแทน AI
อาคาร
Discord
เข้าร่วมกับเพื่อนร่วมงานหลายพันคนและแบ่งปันความคิด
เอกสาร
คำแนะนำและเอกสารอ้างอิงที่ครอบคลุม
เอพีไอ
เอกสารอ้างอิงสำหรับใช้งานกับระบบภายนอก
LLM การจัดอันดับ
เปรียบเทียบประสิทธิภาพและต้นทุนสำหรับผู้ให้บริการโมเดล
วิดีโอ
บทช่วยสอน การสาธิต และการแนะนำผลิตภัณฑ์
บันทึกการเปลี่ยนแปลง
ติดตามข้อมูลอัปเดตล่าสุด Botpress อัพเดท
พันธมิตร
มาเป็นหุ้นส่วน
เข้าร่วมเครือข่ายผู้เชี่ยวชาญที่ผ่านการรับรองของเรา
จ้างผู้เชี่ยวชาญ
เชื่อมต่อกับคู่ค้าและที่ปรึกษา
เอกสาร
องค์กร
ราคา
เข้าสู่ระบบ
ติดต่อไซน์อัพ
กลับไปที่ Hub

โกไฮเลเวล

v1.0.1
ติดตั้งบนพื้นที่ทํางานของคุณ
ดูแลโดย Botpress ทีมเติบโต
  # Botpress Integration: GoHighLevel

## **GoHighLevel OAuth Integration Guide** ##

For further details, refer to the [**GoHighLevel API documentation**](https://highlevel.stoplight.io/docs/integrations/0443d7d1a4bd0-overview). 


### **[Loom video walk through setting up the OAuth configuration.](https://www.loom.com/share/0b7aad49278d4411993c2e88e05405f8?sid=4bbd0c57-b64f-49e6-b6a4-1ab12a05af21)** ###

## **Step 1: Create a Developer App**

1. Go to the [GoHighLevel Marketplace](https://marketplace.gohighlevel.com/).  
2. Sign up for a **developer account** (if you haven’t already).  
3. Navigate to **"My Apps"**, then click on **"Create App."**  
4. Fill in the required details in the form and submit it. Your app will be created.  
5. Click on your newly created app to access its settings.  
6. Configure the required **redirect URI**, **OAuth scopes** and generate API keys.

### **Required OAuth Scopes (If using every card)**

```contacts.readonly
contacts.write
conversations.readonly
users.write
opportunities.readonly
opportunities.write
payments/orders.readonly
payments/orders.write
calendars.readonly
calendars.write
calendars/events.readonly
calendars/events.write
companies.readonly
businesses.readonly
businesses.write
```

## **Step 2: Generate the Authorization URL**

Use the appropriate **authorization URL** based on whether you are using the standard GoHighLevel or a white-label instance.

### **Standard (Non-White Label) URL**
```
https://marketplace.gohighlevel.com/oauth/chooselocation?response_type=code&redirect_uri=BOTPRESS_WEBHOOK/oauth&client_id=CLIENT_ID&scope=contacts.readonly contacts.write conversations.readonly users.write opportunities.readonly opportunities.write payments/orders.readonly payments/orders.write calendars.readonly calendars.write calendars/events.readonly calendars/events.write companies.readonly businesses.readonly businesses.write
```
### **White Label URL**

```
https://marketplace.leadconnectorhq.com/oauth/chooselocation?response_type=code&redirect_uri=BOTPRESS_WEBHOOK/oauth&client_id=CLIENT_ID&scope=contacts.readonly contacts.write conversations.readonly users.write opportunities.readonly opportunities.write payments/orders.readonly payments/orders.write calendars.readonly calendars.write calendars/events.readonly calendars/events.write companies.readonly businesses.readonly businesses.write
```
## **Step 3: Obtain the Authorization Code**

When a user grants access, their browser will be **redirected to the specified redirect URI** with an **authorization code** as a query parameter.

 Example:

 https://myapp.com/oauth/callback/gohighlevel?code=7676cjcbdc6t76cdcbkjcd09821jknnkj

**Copy the authorization code** from the URL.

## **Step 4: Exchange the Code for an Access Token**

1. Go to [GoHighLevel API Token Exchange](https://highlevel.stoplight.io/docs/integrations/00d0c0ecaa369-get-access-token).  
2. Enter the following details:  
   * **Client ID**  
   * **Client Secret**  
   * **Authorization Code** (from Step 3\)  
3. Submit the request.

## **Step 5: Save the Access and Refresh Tokens**

Once you successfully exchange the authorization code, you will receive a response containing:

{  
  "access\_token": "your\_access\_token\_here",  
  "refresh\_token": "your\_refresh\_token\_here",  
}

* **Save the `access_token` and `refresh_token`.**  
* Enter these credentials into **Botpress and your client id and secret id** for authentication.


## Overview
This Botpress integration allows seamless interaction with the **GoHighLevel** CRM. It enables users to manage contacts, opportunities, appointments, and orders directly through their chatbot.

## Features
- **Contacts Management:** Create, retrieve, update, delete, and upsert contacts.
- **Opportunities Management:** Create, update, delete, and retrieve opportunities.
- **Appointments & Calendar Events:** Create, update, retrieve, and delete events.
- **Orders Management:** List orders and retrieve orders by ID.
- **General API Call:** Execute custom API requests to GoHighLevel.


---
## API Functions & Usage
Below are the available actions in this integration:

### 1️⃣ **Contacts Management**

#### **Create Contact**
- **Description:** Creates a new contact.
- **Method:** `POST /contacts/`
- **Input:**
  ```json
  {
    "firstName":"John",
    "lastName":"Doe",
    "locationId":"qWRoUZ6kNRf4Mx3RRtgs"
  }
  ```
- **Output:**
  ```json
  {
    "success": true,
    "message": "Contact created successfully",
    "data": "{contact details}"
  }
  ```

#### **Get Contact**
- **Description:** Retrieves a contact by ID.
- **Method:** `GET /contacts/{contactId}`
- **Input:**
  ```json
    contactId: 123456
  ```
- **Output:** Same as above.

#### **Update Contact**
- **Description:** Updates an existing contact.
- **Method:** `PUT /contacts/{contactId}`
- **Input:**
  ```json
    contactId: 12345
    
  {    
    "firstName": "NewFirstName"
  }
  ```
- **Output:** Same as above.

#### **Delete Contact**
- **Description:** Deletes a contact by ID.
- **Method:** `DELETE /contacts/{contactId}`
- **Input:**
  ```json
    contactId: 123456
  ```
- **Output:**
  ```json
  {
    "success": true,
    "message": "Contact deleted successfully"
  }
  ```

#### **Upsert Contact**
- **Description:** Creates or updates a contact based on existing data.
- **Method:** `POST /contacts/upsert`
- **Input:** Same as `Create Contact`.
- **Output:** Same as `Create Contact`.

#### **Get Contacts by Business ID**
- **Description:** Retrieves contacts for a specific business ID.
- **Method:** `GET /contacts/business/{businessId}`
- **Input:**
  ```json
    businessId: 123456
  ```
- **Output:**
  ```json
  {
    "success": true,
    "message": "Contacts retrieved successfully",
    "data": "{list of contacts}"
  }
  ```

---
### 2️⃣ **Opportunities Management**

#### **Create Opportunity**
- **Description:** Creates a new opportunity.
- **Method:** `POST /opportunities/`
- **Input:**
  ```json
  {
    "pipelineId":"J0VnRDNAXHjlq2GbcnEm",
    "locationId":"qWRoUZ6kNRf4Mx3RRtgs",
    "name":"New Opp",
    "pipelineStageId":"a1ecd775-b7eb-4352-8a07-c2298dca1e7b",
    "status":"open",
    "contactId":"eKJzJtRYlFlcjqiUArC7"
  }
  ```
- **Output:** Same as `Create Contact`.

#### **Get Opportunity**
- **Description:** Retrieves an opportunity by ID.
- **Method:** `GET /opportunities/{opportunityId}`
- **Input:**
  ```json
    opportunityId: 123456
  ```
- **Output:** Same as above.

#### **Update Opportunity**
- **Description:** Updates an opportunity.
- **Method:** `PUT /opportunities/{opportunityId}`
- **Input:** Same as `Update Contact`.
- **Output:** Same as `Update Contact`.

#### **Update Opportunity Status**
- **Description:** Updates an opportunity.
- **Method:** `PUT /opportunities/{opportunityId}`
- **Input:** Same as `Update Contact`.
- **Output:** Same as `Update Contact`.

#### **Delete Opportunity**
- **Description:** Deletes an opportunity by ID.
- **Method:** `DELETE /opportunities/{opportunityId}`
- **Input:**
  ```json
    opportunityId: 123456
  ```
- **Output:** Same as `Delete Contact`.

#### **Upsert Opportunity**
- **Description:** Creates or updates an opportunity.
- **Method:** `POST /opportunities/upsert`
- **Input:** Same as `Create Opportunity`.
- **Output:** Same as `Create Opportunity`.

---
### 3️⃣ **Orders Management**

#### **List Orders**
- **Description:** Retrieves a list of orders.
- **Method:** `GET /payments/orders`
- **Input:**
  ```json
  {
    "altId": "string",
    "altType": "string"
  }
  ```
- **Output:**
  ```json
  {
    "success": true,
    "message": "Orders retrieved successfully",
    "data": "{list of orders}"
  }
  ```

#### **Get Order By ID**
- **Description:** Retrieves an order by ID.
- **Method:** `GET /payments/orders/{orderId}`
- **Input:**
  ```json
    orderId: 123
    altId: 123
    altType: abc
  ```
- **Output:** Same as above.

---
### 4️⃣ **Appointments & Calendar Events**

#### **Create Appointment**
- **Description:** Creates an Appointment.
- **Method:** `POST /calendars/events/appointments`
- **Input:**
  ```json
    {
      "calendarId":"5Bv4N9KLGetAIdfZCyGo",
      "locationId":"qWRoUZ6kNRf4Mx3RRtgs",
      "contactId":"655SZAMnQw45ImQenL3b",
      "startTime":"2025-07-23T03:30:00+05:30"
    }
  ```
- **Output:** Same as above.

#### **Get Appointment**
- **Description:** Gets an Appointment.
- **Method:** `GET /calendars/events/appointments/{appointmentId}`
- **Input:**
  ```json
    appointmentId: 123456
  ```
- **Output:** Same as above.

#### **Get Calendar Events**
- **Description:** Gets all Appointments for a calendar.
- **Method:** `GET /calendars/events`
- **Input:**
  ```json
    {
      "calendarId":"5Bv4N9KLGetAIdfZCyGo",
      "locationId":"qWRoUZ6kNRf4Mx3RRtgs",
      "startTime":"2025-07-22T15:00:00-07:00",
      "endTime":"2025-07-22T16:00:00-07:00"
    }
  ```
- **Output:** Same as above.

#### **Update Appointment**
- **Description:** Updates an Appointment.
- **Method:** `PUT /calendars/events/appointments/{appointmentId}`
- **Input:**
  ```json
    {
      "startTime":"2025-11-22T15:00:00-07:00",
      "title":"Updated event"
    }
  ```
- **Output:** Same as above.

#### **Delete Event**
- **Description:** Deletes an Appointment.
- **Method:** `DELETE /calendars/events/{eventId}`
- **Input:**
  ```json
    appointmentId: 123456
  ```
- **Output:** Same as above.

---
### 5️⃣ **General API Call**

- **Method:** Dynamic
- **Input:**
  ```json
  {
    "endpoint": "string",
    "method": "GET | POST | PUT | DELETE",
    "data": "Optional JSON object",
    "params": "Optional params"
  }
  ```
- **Output:** Dynamic based on response.
---
## Notes
- API responses are standardized to include `success`, `message`, and `data`.

For further details, refer to the [**GoHighLevel API documentation**](https://highlevel.stoplight.io/docs/integrations/0443d7d1a4bd0-overview).

---

**🔗 Developed for seamless CRM automation in Botpress.** 🚀


สร้างสิ่งที่ดีกว่าด้วย Botpress

สร้างประสบการณ์ตัวแทน AI ที่น่าทึ่ง

เริ่มต้นใช้งานฟรี
ไอคอนลูกศร
เรียนรู้เพิ่มเติมที่ Botpress Academy

สร้างตัวแทน AI ได้ดีขึ้นและรวดเร็วยิ่งขึ้นด้วยหลักสูตร คำแนะนำ และบทช่วยสอนที่เราคัดสรรมา

จ้างผู้เชี่ยวชาญ

เชื่อมต่อกับนักพัฒนาที่ผ่านการรับรองของเราเพื่อค้นหาผู้สร้างผู้เชี่ยวชาญที่เหมาะกับความต้องการของคุณ

การดําเนินงานของระบบทั้งหมด
SOC 2
รับรอง
จีดีพีอาร์
ได้มาตรฐาน
© 2025
แท่น
ราคา
สตูดิโอตัวแทน
เครื่องยนต์อัตโนมัติ
ฐานความรู้
ตาราง
ฮับ
การบูรณาการ
ช่อง
LLMs
ทรัพยากร
พูดคุยกับฝ่ายขาย
การเอกสาร
จ้างผู้เชี่ยวชาญ
วิดีโอ
เรื่องราวของลูกค้า
ข้อมูลอ้างอิง API
บล็อก
สถานะ
ทรัพยากร v12
ชุมชน
การสนับสนุนชุมชน
มาเป็นหุ้นส่วน
มาเป็นเอกอัครราชทูต
ร่วมเป็นพันธมิตร
บริษัท
ประมาณ
อาชีพ
ข่าวสาร
ชอบด้วยกฎหมาย
ความเป็นส่วนตัว
Botpress 2025