From 590069568af50c893bac13a71ddfc4030144c51c Mon Sep 17 00:00:00 2001
From: adkah <98672834+adkah@users.noreply.github.com>
Date: Mon, 22 Dec 2025 09:09:11 +0000
Subject: [PATCH] chore: update integration docs
---
.../integrations/cards/botpress/gmail.mdx | 1066 +++++++++++++++++
.../integrations/cards/botpress/gsheets.mdx | 68 +-
snippets/integrations/cards/botpress/make.mdx | 2 +-
.../integrations/cards/botpress/messenger.mdx | 33 +
.../integrations/cards/botpress/openai.mdx | 2 +-
.../integrations/cards/botpress/zendesk.mdx | 75 ++
.../triggers/botpress/whatsapp.mdx | 2 +-
snippets/integrations/versions.mdx | 52 +-
8 files changed, 1240 insertions(+), 60 deletions(-)
create mode 100644 snippets/integrations/cards/botpress/gmail.mdx
diff --git a/snippets/integrations/cards/botpress/gmail.mdx b/snippets/integrations/cards/botpress/gmail.mdx
new file mode 100644
index 00000000..104d41de
--- /dev/null
+++ b/snippets/integrations/cards/botpress/gmail.mdx
@@ -0,0 +1,1066 @@
+{/* This file is auto-generated. Do not edit directly. */}
+{/* vale off */}
+
+Here's a reference for all [Cards](/studio/concepts/cards/introduction) available with the integration:
+
+### Change Message Labels
+
+{"Modifies the labels on the specified message by adding or removing label IDs."}
+
+
+
+
+ {"The ID of the message to modify."}
+
+
+ {"A list of IDs of labels to add to this message."}
+
+
+ {"A list of IDs of labels to remove from this message."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Create Draft
+
+{"Creates a new draft with the specified email content."}
+
+
+
+
+ {"The recipient email address."}
+
+
+ {"The subject of the email."}
+
+
+ {"The body content of the email."}
+
+
+
+
+
+
+
+ {"The immutable ID of the created draft."}
+
+
+ {"The message content of the draft."}
+
+
+
+ {"The ID of the message."}
+
+
+ {"The ID of the thread."}
+
+
+
+
+
+
+### Create Label
+
+{"Creates a new label in the user's mailbox."}
+
+
+
+
+ {"The display name of the label to create."}
+
+
+
+
+
+
+
+ {"The immutable ID of the created label."}
+
+
+ {"The display name of the label."}
+
+
+ {"The owner type for the label (system or user)."}
+
+
+
+
+### Delete Draft
+
+{"Immediately and permanently deletes the specified draft. This operation cannot be undone."}
+
+
+
+
+ {"The ID of the draft to delete."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Delete Label
+
+{"Immediately and permanently deletes the specified label. Messages and threads are not deleted, they simply lose this label."}
+
+
+
+
+ {"The ID of the label to delete."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Delete Message
+
+{"Immediately and permanently deletes the specified message using its ID. This operation cannot be undone. Prefer messages.trash instead"}
+
+
+
+
+ {"The ID of the message to delete."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Get Draft
+
+{"Gets the specified draft by its ID."}
+
+
+
+
+ {"The ID of the draft to retrieve."}
+
+
+
+
+
+
+
+ {"The immutable ID of the draft."}
+
+
+ {"The message content of the draft."}
+
+
+
+ {"The ID of the message."}
+
+
+ {"The ID of the thread."}
+
+
+ {"List of label IDs applied to the draft message."}
+
+
+ {"A short part of the message text."}
+
+
+
+
+
+
+### Get Label
+
+{"Gets the specified label by its ID."}
+
+
+
+
+ {"The ID of the label to retrieve."}
+
+
+
+
+
+
+
+ {"The immutable ID of the label."}
+
+
+ {"The display name of the label."}
+
+
+ {"The owner type for the label (system or user)."}
+
+
+ {"The visibility of messages with this label in the message list."}
+
+
+ {"The visibility of the label in the label list."}
+
+
+ {"The total number of messages with the label."}
+
+
+ {"The number of unread messages with the label."}
+
+
+ {"The total number of threads with the label."}
+
+
+ {"The number of unread threads with the label."}
+
+
+ {"The color to assign to the label."}
+
+
+
+ {"The background color."}
+
+
+ {"The text color."}
+
+
+
+
+
+
+### Get Message Attachment
+
+{"Gets the specified message attachment by its ID."}
+
+
+
+
+ {"The ID of the message containing the attachment."}
+
+
+ {"The ID of the attachment to retrieve."}
+
+
+
+
+
+
+
+ {"The attachment retrieved from the message."}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Get Message Attachment From Mail
+
+{"Gets the first attachment from a message by automatically finding the attachment ID from the message."}
+
+
+
+
+ {"The ID of the message containing the attachment."}
+
+
+
+
+
+
+
+ {"The attachment retrieved from the message."}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Get Thread
+
+{"Gets the specified thread by its ID, including all messages in the thread."}
+
+
+
+
+ {"The ID of the thread to retrieve."}
+
+
+
+
+
+
+
+ {"The unique ID of the thread."}
+
+
+ {"A short part of the message text."}
+
+
+ {"The history ID of the thread."}
+
+
+ {"The list of messages in the thread."}
+
+
+
+ {"The ID of the message."}
+
+
+ {"The ID of the thread the message belongs to."}
+
+
+ {"List of label IDs applied to this message."}
+
+
+ {"A short part of the message text."}
+
+
+
+
+
+
+### List Drafts
+
+{"Lists all drafts in the user's mailbox."}
+
+
+ This Card has no input fields.
+
+
+
+
+
+ {"List of drafts."}
+
+
+
+ {"The immutable ID of the draft."}
+
+
+ {"The message content of the draft."}
+
+
+
+ {"The ID of the message contained in the draft."}
+
+
+ {"The ID of the thread the draft belongs to."}
+
+
+
+
+
+
+ {"Estimated total number of results."}
+
+
+
+
+### List Labels
+
+{"Lists all labels in the user's mailbox, including system labels and user-created labels."}
+
+
+ This Card has no input fields.
+
+
+
+
+
+ {"List of labels."}
+
+
+
+ {"The immutable ID of the label."}
+
+
+ {"The display name of the label."}
+
+
+ {"The owner type for the label (system or user)."}
+
+
+
+
+
+
+### List Threads
+
+{"Lists all email threads in the user's mailbox."}
+
+
+ This Card has no input fields.
+
+
+
+
+
+ {"List of threads in the mailbox."}
+
+
+
+ {"The unique ID of the thread."}
+
+
+ {"A short part of the message text."}
+
+
+ {"The history ID of the thread."}
+
+
+
+
+ {"Estimated total number of results."}
+
+
+
+
+### Send Draft
+
+{"Sends the specified draft. The draft will be deleted after being sent."}
+
+
+
+
+ {"The ID of the draft to send."}
+
+
+
+
+
+
+
+ {"The ID of the sent message."}
+
+
+ {"The ID of the thread the message belongs to."}
+
+
+ {"List of label IDs applied to the sent message."}
+
+
+
+
+### Trash Message
+
+{"Moves the specified message to the trash. The message can be restored from the trash using untrashMessage."}
+
+
+
+
+ {"The ID of the message to trash."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Trash Thread
+
+{"Moves the specified thread to the trash. All messages in the thread will be moved to trash. The thread can be restored using untrashThread."}
+
+
+
+
+ {"The ID of the thread to trash."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Untrash Message
+
+{"Removes the specified message from the trash and restores it to the inbox."}
+
+
+
+
+ {"The ID of the message to untrash."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Untrash Thread
+
+{"Removes the specified thread from the trash. All messages in the thread will be restored."}
+
+
+
+
+ {"The ID of the thread to restore from trash."}
+
+
+
+
+
+ This Card has no output.
+
+
+### Update Draft
+
+{"Replaces a draft's content with the new email content provided."}
+
+
+
+
+ {"The ID of the draft to update."}
+
+
+ {"The recipient email address."}
+
+
+ {"The subject of the email."}
+
+
+ {"The body content of the email."}
+
+
+
+
+
+
+
+ {"The immutable ID of the updated draft."}
+
+
+ {"The message content of the draft."}
+
+
+
+ {"The ID of the message."}
+
+
+ {"The ID of the thread."}
+
+
+
+
+
+
+### Update Label
+
+{"Updates the specified label with new properties like name or color."}
+
+
+
+
+ {"The ID of the label to update."}
+
+
+ {"The new display name for the label."}
+
+
+ {"The background color as hex string (e.g., #ffffff)."}
+
+
+ {"The text color as hex string (e.g., #000000)."}
+
+
+
+
+
+
+
+ {"The immutable ID of the label."}
+
+
+ {"The display name of the label."}
+
+
+ {"The owner type for the label (system or user)."}
+
+
+ {"The color assigned to the label."}
+
+
+
+ {"The background color."}
+
+
+ {"The text color."}
+
+
+
+
+
+
+
+{/* vale on */}
\ No newline at end of file
diff --git a/snippets/integrations/cards/botpress/gsheets.mdx b/snippets/integrations/cards/botpress/gsheets.mdx
index cb485808..8132db5c 100644
--- a/snippets/integrations/cards/botpress/gsheets.mdx
+++ b/snippets/integrations/cards/botpress/gsheets.mdx
@@ -77,7 +77,7 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl
### Append Values
-{"Appends values to the spreadsheet. The input range is used to search for existing data and find a \"table\" within that range. Values will be appended to the next row of the table, starting with the first column of the table."}
+{"Appends values to the spreadsheet. The input startColumn is used to search for existing data and find a \"table\" within that range. Values will be appended to the next row of the table, starting with the first column of the table."}
+ {"The name of the sheet (e.g. \"Sheet1\"). If not provided, the first visible sheet is used."}
+
+
- {"The A1 notation of a range to search for a logical table of data. Values are appended after the last row of the table. (e.g. \"Sheet1!A1:B2\")"}
+ {"The start column letter(s) (e.g. \"A\", \"B\", \"AA\"). The range will be constructed from this column row 1 to column row 100000."}
- {"The spreadsheet ID."}
+ {"The unique identifier of the spreadsheet."}
-### Unprotect Range
-
-{"Removes protection from a protected range in the spreadsheet."}
-
-
-
-
- {"The ID of the protected range to unprotect."}
-
-
-
-
-
- This Card has no output.
-
-
-### Update Values
+### Set Values
{"Sets values in a range in the spreadsheet."}
@@ -881,5 +861,31 @@ Available options: `ROWS`, `COLUMNS`
+### Unprotect Range
+
+{"Removes protection from a protected range in the spreadsheet."}
+
+
+
+
+ {"The ID of the protected range to unprotect."}
+
+
+
+
+
+ This Card has no output.
+
+
{/* vale on */}
\ No newline at end of file
diff --git a/snippets/integrations/cards/botpress/make.mdx b/snippets/integrations/cards/botpress/make.mdx
index ae466df1..f7b57a0c 100644
--- a/snippets/integrations/cards/botpress/make.mdx
+++ b/snippets/integrations/cards/botpress/make.mdx
@@ -38,7 +38,7 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl
name="response"
type="string | null"
>
- {"Data received from Make.com, will be the string `Accepted` if successful and no data is returned"}
+
diff --git a/snippets/integrations/cards/botpress/messenger.mdx b/snippets/integrations/cards/botpress/messenger.mdx
index b8254ffb..8e946c30 100644
--- a/snippets/integrations/cards/botpress/messenger.mdx
+++ b/snippets/integrations/cards/botpress/messenger.mdx
@@ -115,6 +115,39 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl
+### Start DM Conversation from Comment
+
+{"Start a DM conversation from a comment"}
+
+
+
+
+ {"The ID of the comment to start the conversation from"}
+
+
+ {"The message to send to the user"}
+
+
+
+
+
+ This Card has no output.
+
+
### Start Typing Indicator
{"Model to use for content generation"}
-Available options: `gpt-5.1-2025-11-13`, `gpt-5-2025-08-07`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `o4-mini-2025-04-16`, `o3-2025-04-16`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `o3-mini-2025-01-31`, `o1-2024-12-17`, `o1-mini-2024-09-12`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`
+Available options: `gpt-5.2-2025-12-11`, `gpt-5.1-2025-11-13`, `gpt-5-2025-08-07`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `o4-mini-2025-04-16`, `o3-2025-04-16`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `o3-mini-2025-01-31`, `o1-2024-12-17`, `o1-mini-2024-09-12`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`
diff --git a/snippets/integrations/cards/botpress/zendesk.mdx b/snippets/integrations/cards/botpress/zendesk.mdx
index 06055dbf..31b28882 100644
--- a/snippets/integrations/cards/botpress/zendesk.mdx
+++ b/snippets/integrations/cards/botpress/zendesk.mdx
@@ -157,6 +157,27 @@ Available options: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`
required
>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
{"Photo URL of the chatbot that will be used in the Zendesk ticket. Must be a publicly-accessible PNG image. Defaults to Botpress logo."}
+
+
+ {"The name of the requester the bot was talking to. This will be set in zendesk."}
+
+
+ {"⚠️This needs a requester name to work. The email of the requester the bot was talking to. This will be set in zendesk."}
diff --git a/snippets/integrations/triggers/botpress/whatsapp.mdx b/snippets/integrations/triggers/botpress/whatsapp.mdx
index 14f3dee5..10608a3e 100644
--- a/snippets/integrations/triggers/botpress/whatsapp.mdx
+++ b/snippets/integrations/triggers/botpress/whatsapp.mdx
@@ -199,7 +199,7 @@ Available options: `APPROVED`, `ARCHIVED`, `DELETED`, `DISABLED`, `FLAGGED`, `IN
type="string | null"
required
>
- {"Template rejection reason, if rejected."}
+