Collab Actions

Collab.Land is launching a marketplace for Web3 developers and communities. Collab Actions is a tool for contributing apps to this marketplace. Developers can get started with Collab Actions by following the instructions provided in the Getting Started with Collab Actions guide.

Why a Marketplace?

The Web3 ecosystem is hungry for user adoption, and tokenized communities and crypto users demand meaningful features from native platforms such as Discord, Telegram, and Reddit for simpler onboarding and engagement. A decentralized marketplace with distribution channels can connect Web3 applications with the right users.

Why Collab.Land?

• Collab.Land serves over 50,000 tokenized communities with more than 2 million users and 8 million verified wallets. This provides a massive user base for developers to target and enlist their apps.
• Our APIs are highly extensible and supports multiple wallet providers, blockchain networks, and digital assets making it possible for an ecosystem of builders to emerge.
• Collab.Land also allows developers to control the development / deployment process and provides an easy-to-use /test-flight feature for testing in development.

MiniApps

The Apps you develop to list on the Collab.Land marketplace are called miniapps. These miniapps can be developed in one of two ways:

• Via the Colla.Land Code base
• Via Collab Actions.

Build MiniApps via the codebase

This is a legacy approach that we no longer recommend. It introduces the infrastructural overhead of cloning the Collab.Land codebase, setting up locally which could take a considerable amount of time and handling other extras like AWS, security, and auth by yourself.

Build MiniApps via Collab.Land Actions

This is the recommended approach that allows you to build on top existing Action templates with all the underlying infrastruce and security concerns built-in.

• No need to access Collab.Land code base
• No need to provision AWS accounts/resources for development
• The actions are REST API-based and have isolation between the action logic and Collab.Land runtime
• Developers control the development and deployment flow
• Easily test Actions with /test-flight.

Architecture

What kinds of Actions can you build?

• Discord UIs
• Token gating rules
• User profiles
• Community management

Build Actions for Discord commands

Developers can build Actions for Discord commands such as slash commands, popup commands, and message components like buttons, modals, and select menus.

• Slash commands
• Popup commands (user/message)
• Message components
  • Button
  • Modal
  • Select menu

Examples and Resources

We have three example Collab Action templates for you to consider:

• Loopback Hello Action template
• Express Action template
• Python Action template

Learn more about building miniapps with Collab Actions here

📄️ Getting started with Collab Actions

Collab Actions is a collection of tools designed to help create miniapps for the Collab.Land marketplace. By using Collab Actions, the setup and configuration of the Collab.Land infrastructure, which includes Docker, AWS, security measures, and authentication, is automatically managed for you.

📄️ Customize your Collab Action

In the previous section, you learned how to get started with Collab Actions by installing the Express Action template and creating a basic "Hello, World!" Action. In this section, we'll take a step further and learn how to customize the Express Action template to implement your own business logic.

📄️ Build Actions from Template

The recommended way to build a Collab Action is to use any of the provided Collab.Land Action templates. For this example, we'll be using the Express Action template.

📄️ Build a custom Collab Action

Collab Actions is a simple REST API endpoint for building custom Actions for Discord interactions. We recommend using the hello-action template for contributing mini-apps to Collab.Land. However, if you want to build your own custom actions, you can do that by building and exposing the /metadata and /interactions endpoints to Collab.Land.

📄️ Submit your miniapps

Congratulations on completing your miniapp! We're excited to have your creation listed on the Collab.Land marketplace. To make the submission process smooth and successful, please follow the steps below:

📄️ Miniapp Authorization

Collab.Land now supports user authorization for miniapps. This means that developers can take advantage of the Collab.Land API to request user authorization for data access. This enhancement enables developers to build more powerful miniapps that can access user data and build a more personalized experience for users.