NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

The NotificaMe Hub node for n8n enables integration with the NotificaMe Hub API, specifically allowing you to send files (images or videos) via Instagram Direct Messages. The "Enviar Arquivo" operation under the Instagram resource is designed for scenarios where you need to programmatically deliver media content to an Instagram user through a specified channel.

Common use cases:

  • Sending promotional images or videos to followers.
  • Automating customer support by sharing visual instructions or product demos.
  • Delivering event invitations or announcements as media files.

Properties

Below are the input properties required for the "Instagram > Enviar Arquivo" operation:

Display Name Type Description
ID Do Canal String ID do canal do Instagram (Instagram channel ID). Required.
ID Do Destinatário String ID do destinatário no Instagram (Recipient's Instagram ID). Required.
Tipo Do Arquivo Options Tipo do arquivo a ser enviado (Type of file to send). Options: Imagem (image), Vídeo (video). Default: Imagem.
URL Do Arquivo String URL pública do arquivo (Public URL of the file to be sent). Required.

Output

The output will be a JSON object containing the response from the NotificaMe Hub API after attempting to send the file. The structure typically includes:

{
  "success": true,
  "messageId": "string",
  "status": "sent",
  "details": { /* additional info from API */ }
}
  • success: Indicates if the file was sent successfully.
  • messageId: Unique identifier for the sent message.
  • status: Status of the operation (e.g., "sent", "queued", "failed").
  • details: Any additional information returned by the API.

Note: If the API returns binary data (not typical for this operation), it would represent the raw response or file content, but for sending files, the output is expected to be JSON.

Dependencies

  • External Service: Requires access to the NotificaMe Hub API.
  • API Credentials: You must configure the notificamehubApi credential in n8n.
  • Environment: Ensure that the provided file URL (URL Do Arquivo) is publicly accessible by the NotificaMe Hub service.

Troubleshooting

Common Issues:

  • Invalid Channel or Recipient ID: If the IDs are incorrect, the API may return errors such as "Channel not found" or "Recipient not found".
  • Inaccessible File URL: If the file URL is not public or is invalid, you may see errors like "File not accessible" or "Invalid file URL".
  • Unsupported File Type: If the file type does not match the selected option (image/video), the API may reject the request.
  • Authentication Errors: Missing or incorrect API credentials will result in authentication failures.

How to resolve:

  • Double-check all IDs and ensure they correspond to valid Instagram channels and users.
  • Make sure the file URL is reachable from the internet and points directly to the media file.
  • Verify your API credentials in n8n.
  • Ensure the file format matches the selected type (e.g., only send image files when "Imagem" is selected).

Links and References

This summary provides a clear guide for using the "Instagram > Enviar Arquivo" operation in the NotificaMe Hub n8n node.

Discussion