Actions16
- User Actions
- Activity Actions
- Message Actions
Overview
This node interacts with the CoachTrigger API to manage messages related to AI coaching. Specifically, the "Create a Message as AI Coach" operation allows users to send a message from an AI coach to a receiver user within the CoachTrigger system. This is useful in scenarios where automated coaching messages need to be sent programmatically, such as delivering personalized advice, reminders, or motivational content generated by an AI model.
Practical examples include:
- Sending AI-generated coaching tips to employees based on their performance data.
- Automating follow-up messages after coaching sessions.
- Integrating AI coach messaging into broader workflows for employee engagement or training.
Properties
Name | Meaning |
---|---|
Authentication | Choose between two authentication methods: "Company Api" (using a company API key) or "System Api" (using a system API key). |
Coach User ID | The user ID of the coach sending the message. |
Receiver User ID | The user ID of the message recipient. |
Message | The main content of the message to be sent by the AI coach. |
Message Translated | Optional translated version of the message content. |
LLM Model | The name or identifier of the large language model used to generate the message. |
Token In | The count of input tokens used by the AI model (kept confidential). |
Token Out | The count of output tokens generated by the AI model (kept confidential). |
Run ID | An optional identifier for the specific run or session of the AI message generation. |
Thread ID | An optional identifier for the conversation thread to which this message belongs. |
Type | A string representing the type of message; defaults to "0". |
Output
The node outputs a JSON object containing the response from the CoachTrigger API after creating the AI coach message. This typically includes details about the created message such as its ID, status, timestamps, and any metadata returned by the API.
No binary data output is involved in this operation.
Dependencies
- Requires access to the CoachTrigger API endpoint
https://www.coachtriggerapp.com/crmApi/message/from_aicoach
. - Requires either a company API key or a system API key credential configured in n8n for authentication.
- Network connectivity to the CoachTrigger API service.
Troubleshooting
- Authentication errors: If the API key or system key is invalid or missing, the request will fail. Ensure that the correct credentials are set up in n8n and selected properly in the node's Authentication property.
- Missing required fields: The operation requires
coachUserId
andreceiverUserId
. Omitting these will cause errors. - API rate limits or quota exceeded: If too many requests are made in a short time, the API may reject calls. Implement retry logic or check usage limits.
- Invalid token counts or model names: Providing incorrect values for token counts or LLM model may cause unexpected behavior or API errors.
- Network issues: Connectivity problems can cause request failures. Verify network access to the API endpoint.
Links and References
- CoachTrigger API Documentation (assumed URL for reference)
- n8n documentation on HTTP Request Node for understanding API interactions
- General info on AI coaching and messaging automation concepts