Maytapi icon

Maytapi

Integrate with Maytapi WhatsApp Unofficial API

Contact → Check Phones

AI-generated

Overview

The "Check Phones" operation under the "Contact" resource in this Maytapi node allows users to verify whether a list of phone numbers are registered on WhatsApp. This is useful for validating contacts before sending messages or performing other WhatsApp-related actions, ensuring that operations target valid WhatsApp users.

Typical use cases include:

  • Filtering a contact list to only those with active WhatsApp accounts.
  • Validating phone numbers collected from external sources before outreach.
  • Automating workflows that depend on WhatsApp presence verification.

For example, you can input a comma-separated list of phone numbers (without the WhatsApp suffix) and receive a response indicating which numbers are available on WhatsApp.

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 when "Custom" is selected as Phone ID Source.
Phone Numbers Comma-separated list of phone numbers (without @c.us suffix) to check if they are on WhatsApp.

Output

The output JSON contains the response from the Maytapi API's /checkPhones endpoint. It includes information about each phone number's WhatsApp registration status.

The exact structure depends on the API but typically includes fields such as:

  • The phone number checked.
  • A boolean or status indicating if the number is registered on WhatsApp.
  • Possibly additional metadata per number.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for Maytapi WhatsApp Unofficial API.
  • The Phone ID must be provided either via credentials or custom input.
  • Network access to https://api.maytapi.com/api is required.

Troubleshooting

  • Missing Phone ID: If neither credentials nor custom Phone ID is provided, the node throws an error "Phone ID is required." Ensure you configure the Phone ID correctly.
  • Invalid Phone Numbers Format: Phone numbers should be comma-separated without the @c.us suffix. Incorrect formatting may cause API errors or unexpected results.
  • API Errors: Any API request failure will throw an error. Check your API key validity, network connectivity, and Maytapi service status.
  • Empty or No Response: If no phone numbers are provided or the API returns empty, verify the input and try again.

Links and References

Discussion