Wazend API icon

Wazend API

Interact with Wazend API

Overview

This node, named "Wazend API," allows users to interact with the Wazend messaging platform via its API. Specifically, for the resource "Mensaje" and operation "Enviar Contacto," it enables sending one or multiple contact cards through WhatsApp messages. This is useful in scenarios where automated workflows need to share contact information directly within chat conversations, such as customer support bots sending agent contacts, marketing campaigns sharing sales representatives' details, or internal tools distributing team member info.

Practical example: Automatically send a list of company contacts to a user who requests help via WhatsApp, including full names, phone numbers, emails, and organization details.

Properties

Name Meaning
Nombre De La Instancia The name of the instance that will send the contact message.
Número Del Destinatario The recipient's WhatsApp number (in string format).
Contactos A list of contacts to send. Each contact includes:
- Nombre Completo: Full name of the contact.
- Número De WhatsApp: WhatsApp number (digits only, e.g., 559999999999).
- Número Formateado: Formatted phone number (e.g., +55 99 9 9999-9999).
- Organización: Organization or company name.
- Email: Contact's email address.
- URL: Contact's webpage URL.

Output

The node outputs a JSON array containing the response from the Wazend API after attempting to send the contact(s). The exact structure depends on the API response but typically includes status information about the message delivery.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Wazend API.
  • The base URL for API requests is https://docs.wazend.net/wazend.
  • Proper configuration of the API credential in n8n is necessary.
  • The node uses standard HTTP headers for JSON communication (Accept: application/json, Content-Type: application/json).

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrectly formatted phone numbers may result in message delivery errors.
    • Sending empty contact lists or missing required contact fields can cause the API to reject the request.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • "Operação não suportada." indicates that the selected operation-resource combination is not implemented; verify you have chosen a supported operation.
    • API error responses may include validation errors for contact fields; ensure all required fields are correctly filled.
  • Resolutions:

    • Double-check API credentials and permissions.
    • Validate phone number formats according to WhatsApp standards.
    • Ensure all required contact properties are provided.
    • Test network connectivity and proxy settings if applicable.

Links and References

  • Wazend API Documentation (base URL used by the node)
  • WhatsApp contact card formatting guidelines (refer to official WhatsApp Business API docs)

Discussion