docs: Update $(customapi) and $(ffzemotes) documentation

Author: styler

docs/chatbot/variables/customapi.md

@@ -1,20 +1,25 @@
 ---
 id: customapi
 sidebar_label: "$(customapi)"
-description: "Learn how to use the $(customapi) variable in StreamElements Chatbot to make API requests and display responses in chat."
+description: "Learn how to use $(customapi) in StreamElements Chatbot to make API requests and display responses in chat messages."
+tags:
+- variables
+- api
+- integrations
 keywords:
 - StreamElements
 - chatbot
 - customapi
 - API request
 - variable
+- urlfetch
 ---
 
-# $(customapi)
+# $(customapi) Variable
 
 ## Overview
 
-The `$(customapi)` variable allows you to make a request to a specified URL and return the response directly in chat. This powerful feature enables you to integrate external data sources into your stream's chat messages.
+The `$(customapi)` variable enables you to make HTTP requests to external APIs and display the responses directly in your stream's chat. This powerful feature allows you to integrate real-time data from various sources into your chat messages and commands.
 
 ## Usage
 
@@ -24,11 +29,11 @@ To use the `$(customapi)` variable, include it in your chat message or command r
 $(customapi URL)
 ```
 
-Replace `URL` with the actual API endpoint you want to call.
+Replace *URL* with the actual API endpoint you want to call.
 
 ## Examples
 
-### Example 1: Fetching the latest YouTube video
+### Fetching the latest YouTube video
 
 ```
 $(customapi https://decapi.me/youtube/latest_video?id=UCjerlCIbLPQwSnYlClkjDXg)
@@ -39,7 +44,7 @@ Output:
 STREAMELEMENTS PATCH NOTES - SEPTEMBER 10, 2023 #streamelements #updates #patchnotes - https://youtu.be/-q_q37PoaM8
 ```
 
-### Example 2: Getting a random joke
+### Getting a random joke
 
 ```
 $(customapi https://official-joke-api.appspot.com/random_joke)
@@ -52,11 +57,22 @@ Output:
 
 ## Parameters
 
-The `$(customapi)` variable itself does not take any parameters. However, you can include query parameters in the URL you're requesting if the API requires them.
+The `$(customapi)` variable itself doesn't accept parameters. However, you can include query parameters in the URL if the API requires them. For example:
 
+```
+$(customapi https://api.example.com/data?param1=value1&param2=value2)
+```
 
 ## Aliases
 
 - `$(urlfetch)`
 
+## FAQ
+
+**Q: Can I use `$(customapi)` to make POST requests?**
+
+A: No, `$(customapi)` only supports GET requests.
+
+**Q: How can I handle JSON responses?**
 
+A: `$(customapi)` returns the raw response. To parse JSON, you may need to use additional tools or custom integrations.

docs/chatbot/variables/ffzemotes.md

@@ -1,30 +1,84 @@
 ---
 id: ffzemotes
+sidebar_label: "$(ffzemotes)"
+description: "Learn how to use the $(ffzemotes) variable to display active FrankerFaceZ emotes in your Twitch channel."
 tags:
   - chatbot
   - variable
+  - emotes
 keywords:
   - ffz
   - emotes
   - frankerfacez
+  - twitch
+  - chat
 ---
 
-# $(ffzemotes)
+# $(ffzemotes) Variable
+
+## Overview
+
+The `$(ffzemotes)` variable is used to display a list of active FrankerFaceZ (FFZ) emotes in your Twitch channel. This can be helpful for viewers to see which custom emotes are available for use in the chat.
+
+## Usage
 
-Lists the active FrankerFaceZ emotes in the channel.
+To use this variable, simply include `$(ffzemotes)` in your chat message or command response. The chatbot will automatically replace it with a list of active FFZ emotes.
 
-#### Parameters
+## Examples
 
-This variable does not take any parameters.
+### Example 1: Displaying FFZ Emotes
+
+**Command:**
+```
+!ffzemotes
+```
+
+**Chatbot Response:**
+```
+The active FFZ emotes in this channel are: $(ffzemotes)
+```
+
+**Output:**
+```
+The active FFZ emotes in this channel are: LULW KEKW 5Head PogU
+```
 
-#### Example Input
+### Example 2: Creating a Custom Command
 
+**Command:**
 ```
-$(ffzemotes)
+!command add !customemotes Our channel's FFZ emotes: $(ffzemotes)
 ```
 
-#### Example Output
+**Usage:**
+```
+!customemotes
+```
 
+**Chatbot Response:**
 ```
-LULW KEKW 5Head PogU
+Our channel's FFZ emotes: LULW KEKW 5Head PogU
 ```
+
+## Parameters
+
+This variable does not accept any parameters.
+
+## Related Variables
+
+- [$(bttvemotes)](bttvemotes): Lists active BetterTTV emotes in the channel
+- [$(7tvemotes)](7tvemotes): Lists active 7TV emotes in the channel
+
+## FAQ
+
+**Q: How often is the FFZ emote list updated?**
+
+A: The FFZ emote list is cached for 48 hours. To update the list immediately, you can use the command `!emotes reload`.
+
+**Q: Can I filter or limit the number of emotes displayed?**
+
+A: The `$(ffzemotes)` variable doesn't have built-in filtering or limiting options. To manipulate the output, you'll need to use additional StreamElements variables or custom code.
+
+**Q: What if there are no FFZ emotes in the channel?**
+
+A: If there are no active FFZ emotes, the variable will return an empty string.