AiSensy icon

AiSensy

Interact with AiSensy WhatsApp API
Join our community

Actions3

Overview

This node integrates with the AiSensy WhatsApp API to send WhatsApp messages using predefined campaigns. It supports sending messages by selecting a campaign, specifying the recipient's phone number and contact name, and optionally providing template parameters for message customization. This node is useful for automating WhatsApp communications in marketing campaigns, customer support, or notifications, allowing users to send personalized messages efficiently.

Use Case Examples

  1. Sending a WhatsApp message to a customer using a specific campaign with personalized template parameters.
  2. Automating bulk WhatsApp messages for a marketing campaign by iterating over a list of contacts.
  3. Sending a message with media content by providing a media URL and filename along with the campaign details.

Properties

Name Meaning
Campaign Name Name of the campaign to use for sending the message, which determines the message template and settings.
Phone Number Recipient's phone number including country code, used to direct the WhatsApp message to the correct contact.
Contact Name Name of the contact receiving the message, used for personalization or record-keeping.
Template Parameters Comma-separated values to replace placeholders in the campaign's message template, allowing message customization.

Output

JSON

  • success - Indicates if the message was sent successfully.
  • messageResponse - The response object returned from the AiSensy API after sending the message.
  • campaignDetails
    • id - ID of the campaign used to send the message.
    • name - Name of the campaign used.
    • type - Type of the campaign message (e.g., TEXT, MEDIA).
    • status - Current status of the campaign.
    • audienceSize - Number of recipients targeted by the campaign.
    • templateText - Text template of the campaign message.
    • sampleText - Sample text of the campaign template.
    • totalParameters - Total number of template parameters expected by the campaign.
    • parametersUsed - List of template parameters actually used in the message.
  • sentTo
    • phoneNumber - Phone number to which the message was sent.
    • contactName - Name of the contact to whom the message was sent.
  • media
    • url - URL of the media sent with the message, if any.
    • filename - Filename of the media sent with the message, if any.

Dependencies

  • AiSensy API with project ID and API key credentials

Troubleshooting

  • Ensure the campaign name provided matches an existing campaign in AiSensy; otherwise, the node will throw a 'Selected campaign not found' error.
  • Verify that the phone number includes the correct country code and is formatted properly to avoid message delivery failures.
  • If sending media messages, ensure the media URL is accessible and the media type matches the campaign requirements.
  • Check API credentials and project ID configuration to avoid authentication errors when calling the AiSensy API.

Links

  • AiSensy API Documentation - Official documentation for AiSensy WhatsApp API, useful for understanding campaign setup and message sending.

Discussion