MaytapiInstall

Overview

This node integrates with the Maytapi WhatsApp Unofficial API, enabling automation and interaction with WhatsApp accounts, messages, contacts, groups, calls, sessions, and queues. Specifically for the Account resource and Get Logs (Specific Phone) operation, it retrieves logs related to a specific phone ID registered in the Maytapi system.

Use cases include monitoring activity or troubleshooting issues on a particular WhatsApp instance by fetching its logs. For example, a user might want to audit message delivery statuses or error events associated with a specific phone number managed via Maytapi.

Properties

• This property is required when using the Account resource with the Get Logs (Specific Phone) operation.
• It expects a string representing the Phone ID (e.g., "12").

Output

The node outputs an array of JSON objects, each containing the response from the Maytapi API corresponding to the requested operation.

For the Get Logs (Specific Phone) operation, the output JSON contains the logs data for the specified phone ID. The exact structure depends on the Maytapi API response but typically includes log entries detailing events, errors, or activities related to that phone.

No binary data output is produced for this operation.

Example output snippet (conceptual):

{
  "logs": [
    {
      "timestamp": "2024-06-01T12:00:00Z",
      "event": "message_sent",
      "details": { ... }
    },
    {
      "timestamp": "2024-06-01T12:05:00Z",
      "event": "error",
      "details": { ... }
    }
  ]
}

Dependencies

• Requires an API key credential for Maytapi WhatsApp API authentication.
• The node uses the Maytapi REST API endpoint https://api.maytapi.com/api.
• Proper configuration of credentials with a valid API token and optionally a default Phone ID is necessary.
• No additional environment variables are explicitly required beyond the API credentials.

Troubleshooting

• Missing Phone ID Error: If the Phone ID is not provided either via credentials or custom input, the node throws an error: "Phone ID is required. Please provide it in credentials or select custom Phone ID." Ensure the Phone ID is set correctly.
• Invalid Phone ID: Providing an incorrect or unregistered Phone ID will likely result in API errors or empty log responses.
• API Request Failures: Network issues or invalid API keys can cause request failures. Verify API credentials and network connectivity.
• Unsupported Operation: Using operations or resources not supported by the node will throw errors indicating unsupported combinations.

Links and References

• Maytapi Official Website
• Maytapi API Documentation
• n8n Documentation on Creating Custom Nodes

This summary focuses on the Account resource and Get Logs (Specific Phone) operation as requested.