Buzzy AI Chat App

Instructions for implementing the Buzzy AI Chat app template.

Setting Up Your Chatbot Integration Using Buzzy and Make

This guide will walk you through setting up a chatbot integration between Buzzy and Make using a Make Blueprint. Check out the video below to get an overview of the process.

---

Step 1: Get Your Buzzy User ID and API Token

To connect your Buzzy app with Make, you need to retrieve your Buzzy User ID and API Token.

1. Log into Buzzy Workspace.

2. Click on your profile in the top right corner.

3. Navigate to Developer.

4. Copy both:

   • Buzzy User ID

   • Secret API Token

Best Practices

• Use a dedicated API user: Create a new user and assign them as an owner/author. This ensures a stable API connection as this user will never log out of Buzzy.

• Token expiration warning: If you log out of this API user, the token will become invalid.

  • To avoid this, use Buzzy's Login API with the user’s email/password to dynamically fetch a token.

  • More details: Buzzy API Login Docs

---

Step 2: Copy the Buzzy Template App

To speed up development, start with the pre-built Buzzy template. If you haven't already grabbed a copy of the app:

1. Go to the Buzzy template of the AI Chat app.

2. Click "Use Template" to create a copy in your own Buzzy Workspace.

---

Step 3: Create a New Make File

1. Open Make.

2. Create a new scenario (Make file).

3. Download the blueprint here: chatbot_make_blueprint.json (334Kb)

4. In Make create a new Scenario, it should be blank, click the Import Blueprint
5. You should see your chat flow in Make:

   

---

Step 4: Set Up the Webhook

The webhook is the connection point between Buzzy and Make.

1. In Make, locate the webhook module.

2. Click "Add a new webhook".

3. Copy the generated webhook URL.

4. You'll use this URL in Buzzy Datatable rules (next step).

---

Step 5: Configure Buzzy Datatable Rules

The Buzzy Datatable rules will call Make when specific actions happen.

Rule 1: Chat Creation

This rule creates a new chat when a row is submitted in the Chat datatable.

1. Navigate to Buzzy > Chat Datatable.

2. Go to Properties > Rules.

3. Add a new rule.

4. Configure it as follows:

   • Trigger: When a row is submitted.

   • Action Type: sendJSON

   • Call Type: [POST]

   • API Endpoint: Use the Make webhook URL from Step 4.

JSON Payload:

[{
  "chatID":"{{{_id}}}", 
  "messagesMicroAppID":"{{{messages}}}", 
  "action":"createChat", 
  "buzzyAPIEndpoint":"https://worker.buzzycompany.com/api",
  "buzzyAPIUserID":"<your Buzzy API User ID>", 
  "buzzyAPIUserToken":"<your Buzzy API Token>", 
  "makeBuzzyAPIToken":"<your secret key>"
}]

Security Tip The makeBuzzyAPIToken is a private security key to ensure that only your Buzzy app can call the webhook. Generate a long random string to use as this token.

---

Rule 2: Sending Messages

This rule creates a message when a row is submitted in the Messages datatable.

1. Navigate to Buzzy > Messages Datatable.

2. Go to Properties > Rules.

3. Add a new rule.

4. Configure it as follows:

   • Trigger: When a row is submitted.

   • Action Type: sendJSON

   • Call Type: [POST]

   • API Endpoint: Use the Make webhook URL from Step 4.

JSON Payload:

[{
  "messageID":"{{_id}}", 
  "action":"createMessage", 
  "chatID":"{{embeddingRowID}}", 
  "buzzyAPIEndpoint":"https://worker.buzzycompany.com/api",
  "buzzyAPIUserID":"<your Buzzy API User ID>", 
  "buzzyAPIUserToken":"<your Buzzy API Token>", 
  "makeBuzzyAPIToken":"<your secret key>"
}]

---

Step 6: Testing the Integration

Before launching, confirm that everything is working:

1. Submit a chat in Buzzy.

2. Check if Make receives the webhook call.

3. Ensure that the AI service (e.g., OpenAI, Anthropic, R1) is responding.

4. Submit a message and verify it appears in Make and in the chat app interface

---

Further Considerations

Once the chatbot integration is working, you may want to expand its capabilities:

Moving to Your Own Buzzy Deployment

• If you’re planning to host your own instance of Buzzy, ensure that the Buzzy API endpoint points to your custom deployment.

Publishing Mobile Apps

• Consider publishing your chatbot as a mobile app on iOS and Android.

Security Enhancements

• Configure permissions on Buzzy Datatables to restrict access.

• Implement Make security filters to prevent unauthorized requests.

---

Final Thoughts

By following these steps, you now have a fully functional chatbot powered by Buzzy, Make, and an AI service. This setup is modular and expandable, allowing you to customize it to your specific needs.

If you have any questions, check out the Buzzy Docs: docs.buzzy.buzz or reach out to the Buzzy Community on Discord.

🚀 Now, go build something amazing!