Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

The Bitrix24 node integrates with the Bitrix24 CRM and business platform, enabling automation workflows to interact with various Bitrix24 resources. Specifically, the Notify - Answer Notification operation allows users to send a response to an existing notification within Bitrix24. This is useful in scenarios where automated systems or users need to programmatically reply to notifications, such as confirming tasks, responding to alerts, or interacting with system messages.

Practical examples include:

  • Automatically acknowledging a system notification after processing.
  • Sending a custom message reply to a personal or public notification.
  • Responding to interactive notifications with buttons or attachments.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24. Options:
• OAuth2 (recommended for production)
• Webhook (simpler but less secure)
• API Key authentication
Message The text content of the notification reply message. Required.
Notification ID The unique identifier of the notification to which the answer is sent. Required.
Options Additional optional settings for the notification reply:
• Attachments: JSON array of files or media to attach
• URL Preview: Show preview for URLs (true/false)
• Sound: Play notification sound (true/false)
• Push: Send push notification (true/false)
• Email: Send email notification (true/false)
• Buttons: JSON array defining interactive buttons
• Confirm Text: Text label for confirm button
• Decline Text: Text label for decline button
• Offset: Numeric offset for pagination (not typically used here)
• Filter: JSON object to filter notifications (not typically used here)
• Order: JSON object to specify sort order (not typically used here)

Output

The node outputs an array of items, each containing a json object representing the result of the notification answer operation. The exact structure depends on the Bitrix24 API response but generally includes confirmation of the action or details about the answered notification.

If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not output binary data.

Dependencies

  • Requires connection to a Bitrix24 instance.
  • Supports three authentication methods: OAuth2, Webhook URL, or API Key credential.
  • Proper configuration of credentials in n8n is necessary depending on the chosen authentication method.
  • Network access to Bitrix24 API endpoints is required.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials can cause authorization failures.
    • Incorrect Notification ID may lead to errors indicating the notification was not found.
    • Malformed JSON in options like attachments or buttons can cause request failures.
    • Insufficient permissions in Bitrix24 user account to answer notifications.

  • Error messages:

    • Errors returned from Bitrix24 API are surfaced in the node output if "Continue On Fail" is enabled.
    • Typical errors include authentication errors, invalid parameters, or API rate limits.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Double-check the Notification ID value.
    • Validate JSON syntax for complex option fields.
    • Ensure the Bitrix24 user has appropriate rights to manage notifications.

Links and References

Discussion