WAHA

Connect with Whatsapp HTTP API

Actions116

Overview

This node operation sends a contact vCard via a chat session. It is useful for automating the sharing of contact information in messaging applications, such as sending a business card or personal contact details to a chat recipient. For example, it can be used in customer support workflows to share agent contact info or in sales automation to send client details.

Use Case Examples

  1. Sending a vCard contact to a WhatsApp chat session to share contact details.
  2. Automating the distribution of multiple contact vCards to different chat IDs in a batch process.

Properties

Name Meaning
Session The chat session identifier used to send the contact vCard.
Chat Id The identifier of the chat where the contact vCard will be sent.
Contacts A JSON array of contact vCards to be sent, each containing vCard formatted contact information.
Request Options Optional settings for request handling such as batching, SSL certificate validation, proxy configuration, and request timeout.

Output

JSON

  • sent - Indicates whether the contact vCard was successfully sent.
  • chatId - The chat identifier where the vCard was sent.
  • contacts - The list of contact vCards that were sent.

Dependencies

  • Requires an API key credential or authentication token for the messaging service to send contact vCards.

Troubleshooting

  • Ensure the session and chatId are valid and active; invalid identifiers will cause sending failures.
  • Verify the vCard JSON format is correct; malformed vCards will be rejected by the messaging service.
  • If batching is enabled, check batch size and interval settings to avoid rate limiting or timeouts.
  • If SSL errors occur, consider enabling 'Ignore SSL Issues' only if safe to do so.
  • Proxy settings must be correct if used; incorrect proxy configuration can block requests.

Links

  • vCard Format - Information about the vCard format used for contact sharing.
  • WhatsApp Business API - Official API documentation for sending messages including contact vCards.

Discussion