izapp - WhatsApp icon

izapp - WhatsApp

Interação com a Plataforma de Relacionamento via WhatsApp - IZapp
Join our community

Actions58

Overview

This node integrates with a WhatsApp-based marketing and communication platform, enabling users to send various types of messages through specified channels. The "Marketing - Mensagem - Enviar" operation allows sending notifications or marketing messages to recipients via WhatsApp or other supported channels.

Common scenarios for this node include:

  • Sending promotional campaigns or alerts to customers.
  • Delivering personalized messages such as text, images, videos, audio, files, location maps, vCards, or templated messages.
  • Automating customer engagement by dispatching structured template messages compliant with WhatsApp Business API or BSP providers.
  • Sharing contact information or locations directly within conversations.

Practical examples:

  • A business sends a text message notification about a flash sale to a customer’s WhatsApp number.
  • An event organizer shares a map location of the venue using the map message type.
  • Customer support sends a vCard containing contact details for follow-up.
  • Marketing teams use predefined templates with variables to send personalized campaign messages.

Properties

Name Meaning
Atenção: SPAM pode gerar penalidades em seu Canal Notice warning that WhatsApp may penalize accounts suspected of spamming.
Número De Telefone Recipient's phone number in international format (e.g., 5527998282828).
Nome Do Destinatário Recipient's name.
ID Canal Channel ID through which the message will be sent (e.g., Y0 for WhatsApp).
Tipo De Mensagem Type of message to send. Options: Arquivo (file), Áudio (audio), BSP Template (Interaxa), BSP Template (Messangi), Imagem (image), Mapa (map), Texto (text), VCard (vcard), Vídeo (video), WABA Template (WhatsApp Cloud API). Default is Texto (text).
Texto Text content of the message (used if type is text, image, or video).
URL URL of the media file to send (for image, video, audio, or file message types).
ID Do VCard Name of the vCard contact (used if type is vcard).
Telefone Do VCard Phone number of the vCard contact in international format (used if type is vcard).
Nome Do Local Name of the location to send on the map (used if type is map).
Latitude Latitude coordinate of the location (used if type is map).
Longitude Longitude coordinate of the location (used if type is map).
ID Do Template Template ID for Interaxa, Messangi, or WhatsApp Business API templates (used if type is template, waba_template, or messangi).
Variáveis Do WABA JSON object with variables to populate the WhatsApp Business API template (used if type is waba_template).
Registro Do Template Do WhatsApp Business Api Cloud Notice indicating the template is created in WhatsApp Business API Cloud (required for waba_template).
Variáveis Do Messangi JSON object with variables to populate the Messangi template (used if type is messangi).
Registro Do Template Do BSP Messangi Notice indicating the template is created in BSP Messangi (required for messangi).
Registro Do Template Do BSP Interaxa Notice indicating the template is created in BSP Interaxa (required for template).

Output

The node outputs an array of JSON objects representing the result of the send operation. Each output item typically contains information about the success or failure of the message delivery, including any response data from the messaging platform.

If the message includes media (image, video, audio, file), the node handles sending the media via the provided URL but does not output binary data itself.

Dependencies

  • Requires connection to the external WhatsApp marketing/communication platform via an API.
  • Needs an API key or authentication token configured in n8n credentials to authorize requests.
  • The channel ID must correspond to a valid channel configured in the external platform (e.g., WhatsApp).
  • For template messages, appropriate templates must be pre-registered and approved in the respective BSP or WhatsApp Business API environment.

Troubleshooting

  • SPAM Penalties: Users should heed the spam notice property; sending unsolicited bulk messages can lead to account penalties or suspension by WhatsApp.
  • Invalid Phone Number Format: Ensure phone numbers are in the correct international format without spaces or special characters.
  • Missing Required Fields: Some message types require specific fields (e.g., URL for media, template ID for templates). Omitting these will cause errors.
  • Template Not Registered or Approved: Using unregistered or unapproved templates will result in message rejection.
  • Authentication Errors: Invalid or missing API credentials will prevent message sending.
  • Channel ID Errors: Using an incorrect or inactive channel ID will cause failures.
  • Network or API Errors: Temporary connectivity issues or API rate limits may cause errors; retry logic might be necessary.

Links and References

Discussion