SacNews - Relacionamento icon

SacNews - Relacionamento

Interação com a Plataforma de Relacionamento via WhatsApp - SacNews

Actions59

Overview

This node integrates with a customer relationship platform via WhatsApp, specifically focusing on sending messages related to service protocols. The "Protocolo - Mensagem - Enviar" operation allows users to send various types of messages (text, media, contact cards, location maps) directly linked to a specific service protocol number. This is useful in scenarios where automated or manual communication needs to be sent to customers regarding their ongoing service requests or support tickets.

Practical examples include:

  • Sending a text update about the status of a service request.
  • Sharing an image or video related to the protocol.
  • Sending a contact card (vCard) for follow-up.
  • Providing a map location relevant to the service.

Properties

Name Meaning
ID Do Protocolo The unique protocol number to which the message will be sent (required).
Tipo Da Mensagem Type of message to send. Options: Arquivo (file), Áudio (audio), Imagem (image), Mapa (map), Texto (text), VCard (vcard), Vídeo (video).
Texto Da Mensagem Text content of the message, applicable for text, image, and video message types.
URL Da Mídia URL of the media file to send, used for image, video, audio, or file message types.
Nome Do Contato (VCard) Contact name to include in the vCard message type.
Telefone (VCard) Phone number to include in the vCard message type.
Nome Do Lugar (Mapa) Name of the place to send in the map message type.
Latitude (Mapa) Latitude coordinate for the map location message type.
Longitude (Mapa) Longitude coordinate for the map location message type.

Output

The node outputs JSON data representing the result of the message sending operation. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the sending failed.

If the message involves media, the output confirms the successful handling of the media URL or attachment.

No binary data output is indicated by the source code.

Dependencies

  • Requires connection to the external customer relationship platform's API that manages WhatsApp interactions.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • The node depends on internal action modules (not detailed here) that handle the actual API calls.

Troubleshooting

  • Common Issues:

    • Invalid or missing protocol number: The message cannot be sent without specifying the correct protocol ID.
    • Incorrect media URLs: Media messages require valid accessible URLs; otherwise, sending will fail.
    • Missing required fields for certain message types (e.g., vCard requires contact name and phone).
    • Authentication errors due to invalid or expired API credentials.

  • Error Messages:

    • Errors related to authorization usually indicate problems with the API key or token setup.
    • Validation errors occur if required parameters are missing or incorrectly formatted.
    • Network or API endpoint errors may happen if the external service is unreachable.

  • Resolutions:

    • Verify all required input properties are correctly set.
    • Ensure media URLs are publicly accessible and correctly formatted.
    • Check and refresh API credentials in n8n settings.
    • Review API documentation for any changes in required parameters or endpoints.

Links and References

  • No direct links provided in the source code.
  • For more information, consult the external platform's official API documentation related to WhatsApp messaging and protocol management.

Discussion