Building your own dream Twitch chat commands

To use a custom-built chat command, add a new custom chat command, enable advanced options, and add one or more URL-fetch response tags to the command.

Fill out the required inputs to tell Moobot how to interact with the remote service.

Moobot retrieves the response for the chat command via an HTTP or HTTPS request (GET or POST) to the destination of your choice.

The destination must return either a plain text or JSON response.

Moobot can insert dynamic data into the URL by using tags.

You can put the dynamic data into the URL's query string, or even as the domain, but Moobot requires the URL to be valid at all times.

Sometimes the URL requires a specific letter casing, which a user's input may affect.

You can transform any user input in the URL to make sure it complies with the URL's requirements.

Select in the «Processing of user input in the URL» input how you want to transform any user input.

Leave the input blank if the user input in the URL does not need any transforming.

The URL is only visible to Moobot Editors who can view your custom chat commands. Exercise caution when including private information or API keys.

For JSON responses, you must specify the location of your objects in the JSON using JSON pointers.

{
    "status": "Message response",
    "delayed": true
}

{
    "status": {
        "message": "Message response",
        "code": 61
    },
    "delayed": true
}

{
    "status": [{
        "message": "None",
        "code": 60
    }, {
        "message": "Message response",
        "code": 61
    }],
    "delayed": true
}

Moobot sends several default headers with each of its URL-fetch requests.

The event log on your Moobot dashboard will display any errors that occur during a fetch. This is useful for debugging while setting up your command.

Unlike standard custom chat commands, Moobot will not post a response to Twitch chat if a request fails. In the chat command's edit menu, you can set a custom failure message to send instead.

Custom-built chat commands have certain restrictions to prevent abuse:

• Connections and read operations have short timeouts.
• Requests do not follow redirects.
• Moobot restricts the maximum size of the request's response.

If a request repeatedly fails these restrictions, Moobot may blacklist the URL temporarily. Persistent failures can result in a permanent blacklisting.

You can share a custom-built chat command by exporting it to a file or link. Anyone can then use that file or link to import the command into their own Moobot.

Use Moobot's Import & Export tool to share your commands.