Green API icon

Green API

Send WhatsApp messages via Green API

Actions29

Message → Send Contact

AI-generated

Overview

This node operation sends a contact message via WhatsApp using the Green API. It allows users to specify the chat ID where the contact should be sent, along with the contact's phone number and optional details such as first name, middle name, last name, and company. It supports quoting a previous message and overriding default API credentials for this specific operation. This is useful for automating the sharing of contact information in WhatsApp chats, for example, sending a business contact card to a client or sharing a colleague's contact details in a group chat.

Use Case Examples

  1. Sending a contact card to a private chat by specifying the recipient's chat ID and the contact's phone number and name.
  2. Sharing a contact in a group chat by providing the group chat ID and the contact details.
  3. Overriding the default API credentials to send a contact message from a different Green API instance.

Properties

Name Meaning
Chat ID The WhatsApp chat ID where the contact message will be sent. Use phone@c.us for private chats or chatId@g.us for group chats.
Phone Contact The phone number of the contact to send, in international format without the plus sign.
First Name Optional first name of the contact.
Middle Name Optional middle name of the contact.
Last Name Optional last name of the contact.
Company Optional company name of the contact.
Override Credentials Optional override for the instance ID and API token credentials for this specific operation.
Quoted Message ID Optional ID of a message to quote when sending the contact message.

Output

JSON

  • chatId - The chat ID where the contact message was sent.
  • contact
    • phoneContact - The phone number of the contact sent.
    • firstName - The first name of the contact sent, if provided.
    • middleName - The middle name of the contact sent, if provided.
    • lastName - The last name of the contact sent, if provided.
    • company - The company name of the contact sent, if provided.
  • quotedMessageId - The ID of the quoted message, if any.
  • messageId - The ID of the sent contact message returned by the API.

Dependencies

  • Green API service with instance ID and API token credentials

Troubleshooting

  • Ensure the chat ID is correctly formatted (phone@c.us for private chats, chatId@g.us for groups).
  • Verify the phone contact number is in international format without the plus sign.
  • Check that the API credentials (instance ID and API token) are valid and have the necessary permissions.
  • If overriding credentials, ensure the override values are correct.
  • Common error messages include failures to send the contact due to invalid parameters or network issues; verify the data sent matches the expected format and retry if needed.

Links

  • Green API Documentation - Official documentation for the Green API used to send WhatsApp messages, including contact messages.

Discussion