Maytapi icon

Maytapi

Integrate with Maytapi WhatsApp Unofficial API

Actions55

Contact → Get Contact

AI-generated

Overview

This node integrates with the Maytapi WhatsApp Unofficial API to perform various WhatsApp-related actions. Specifically, for the Contact resource and Get Contact operation, it retrieves detailed information about a specific WhatsApp contact using their conversation ID.

This is useful when you want to fetch metadata or profile details of a WhatsApp contact within an automation workflow. For example, you might use this to verify contact information before sending messages or to enrich your CRM data with WhatsApp contact details.

Properties

Name Meaning
Phone ID Source Select how to provide the Phone ID: either "From Credentials" (uses stored credentials) or "Custom" (enter manually).
Phone ID The WhatsApp instance Phone ID to use if "Custom" is selected as Phone ID Source. Required in that case.
Conversation ID The unique identifier of the contact's conversation, typically the phone number with @c.us suffix. This identifies the contact to retrieve.

Output

The output JSON contains the response from the Maytapi API endpoint /getContacts/{conversationId}. It includes detailed information about the specified WhatsApp contact such as name, status, profile picture URL, and other metadata provided by the API.

No binary data is output for this operation.

Example output structure (simplified):

{
  "id": "905301234567@c.us",
  "name": "Contact Name",
  "profilePicUrl": "https://...",
  "status": "Hey there! I am using WhatsApp.",
  ...
}

Dependencies

  • Requires an active Maytapi API key credential configured in n8n.
  • The Phone ID must be provided either via credentials or custom input.
  • Internet access to call the Maytapi API endpoints.

Troubleshooting

  • Error: "Phone ID is required."
    Ensure that the Phone ID is correctly set either in the credentials or entered manually if "Custom" is selected.

  • Invalid Conversation ID
    The conversation ID must be a valid WhatsApp contact ID, usually a phone number followed by @c.us. Incorrect formatting will cause API errors.

  • API Authentication Errors
    Verify that the Maytapi API key credential is valid and has the necessary permissions.

  • Network Issues
    Ensure the server running n8n can reach the Maytapi API endpoint (https://api.maytapi.com/api).

Links and References

Discussion