Actions80
- Todos Actions
- Card Tables Actions
- Forwards Actions
- Events Actions
- Recordings Actions
- Projects Actions
- People Actions
- Chatbots Actions
- Webhooks Actions
- Attachments Actions
- Templates Actions
- Uploads Actions
- Documents Actions
- Lineup Markers Actions
- Subscriptions Actions
- Schedules Actions
- Schedule Entries Actions
- Todo Sets Actions
- Todo Lists Actions
Overview
This node operation allows you to create a new chatbot within the Basecamp platform. The chatbot can be configured with a unique service name and a command URL that Basecamp will call when the bot is addressed. This is useful for automating interactions, responding to commands, or integrating custom workflows triggered by chat messages in Basecamp.
Practical examples include:
- Creating a chatbot that listens for specific commands in a Basecamp chat and triggers automated tasks.
- Setting up a notification bot that responds to queries about project status.
- Integrating external services via the command URL to extend Basecamp’s chat capabilities.
Properties
| Name | Meaning |
|---|---|
| Bucket Id | Numeric identifier of the Basecamp bucket where the chatbot will be created. |
| Chat Id | Numeric identifier of the Basecamp chat associated with the chatbot. |
| Service Name | The unique name of the chatbot used to invoke queries and commands. Must not contain spaces, emojis, or non-word characters. |
| Command Url | HTTPS URL that Basecamp calls when the chatbot is addressed; this URL handles incoming commands or queries. |
Output
The node outputs JSON data representing the newly created chatbot object as returned by the Basecamp API. This typically includes details such as the chatbot's ID, service name, associated bucket and chat IDs, and the command URL.
If the node supports binary data output (not indicated here), it would represent any files or media related to the chatbot creation response, but this is not applicable based on the provided code.
Dependencies
- Requires an active Basecamp account with appropriate permissions.
- Needs an API authentication token configured in n8n credentials to authorize requests to the Basecamp API.
- The node uses the Basecamp API endpoint constructed dynamically using the Basecamp account ID from credentials.
Troubleshooting
- Invalid Service Name: If the service name contains spaces, emojis, or special characters, the API may reject the request. Ensure the service name follows the allowed pattern.
- Authentication Errors: Missing or invalid API credentials will cause authorization failures. Verify that the API key or OAuth token is correctly set up in n8n.
- Incorrect Bucket or Chat IDs: Providing non-existent or unauthorized bucket/chat IDs will result in errors. Confirm these IDs are valid and accessible.
- Command URL Issues: The command URL must be a valid HTTPS URL reachable by Basecamp. Invalid URLs or unreachable endpoints will cause failures when the bot is invoked.
Links and References
- Basecamp API Documentation
- n8n Documentation - Creating Custom Nodes
- Basecamp Chatbots Overview (for general understanding of chatbot usage in Basecamp)