Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Chatbot → Create a Chatbot

AI-generated

Overview

This node operation creates a chatbot service within a specified project and chat in Basecamp. It is useful for automating interactions in Basecamp chats by setting up a chatbot that can respond to queries and commands via a specified HTTPS URL. For example, a user can create a chatbot to handle common questions or automate tasks in a project chatroom.

Use Case Examples

  1. Creating a chatbot service named 'HelpBot' in a project with ID 123 and chat ID 456, which listens to commands at a specified URL.
  2. Automating responses in a team chat by creating a chatbot that processes commands and queries.

Properties

Name Meaning
Project ID The ID of the project (bucket) where the chatbot will be created. Used in the API endpoint path.
chatId The ID of the chat or campfire within the project where the chatbot will be created. Used in the API endpoint path.
Service Name The name of the chatbot service, used to invoke queries and commands. Must not contain spaces, emojis, or non-word characters.
Command URL The HTTPS URL that Basecamp will call when the chatbot is addressed. This URL handles the chatbot's commands and queries.
Return Full Response Whether to return the full HTTP response including status code, headers, and body, instead of only the response body.

Output

JSON

  • id - The unique identifier of the created chatbot service.
  • service_name - The name of the chatbot service as registered.
  • command_url - The URL that the chatbot service uses to receive commands.
  • created_at - Timestamp when the chatbot was created.
  • updated_at - Timestamp when the chatbot was last updated.

Dependencies

  • Requires an OAuth2 API credential for Basecamp with account ID for authentication.

Troubleshooting

  • Ensure the Project ID and chatId are correct and exist in Basecamp to avoid 404 errors.
  • Verify the Service Name follows the naming rules (no spaces, emojis, or non-word characters) to prevent validation errors.
  • Check the Command URL is a valid HTTPS URL accessible by Basecamp to avoid connection errors.
  • If 'Return Full Response' is enabled, be prepared to handle the full HTTP response structure in downstream nodes.

Discussion