Zappfy API icon

Zappfy API

Interact with Zappfy API
Join our community

Actions48

Overview

The node "Zappfy API" provides an interface to interact with the Zappfy messaging API. Specifically, for the resource Mensagem and operation Enviar Enquete, it allows users to send a poll (enquete) message to a specified recipient via a given instance of the service.

This node is useful in scenarios where automated or programmatic sending of polls is needed, such as gathering feedback, conducting surveys, or running quick votes within chat applications integrated through Zappfy.

Example use cases:

  • Sending customer satisfaction polls after support interactions.
  • Running quick opinion polls in group chats.
  • Collecting votes on event preferences or decisions.

Properties

Name Meaning
Nome Da Instância The name of the instance that will send the poll. This identifies which configured instance to use.
Número Do Destinatário The recipient's number or identifier to whom the poll will be sent.
Titulo Da Enquete The title or caption of the poll message.
Opções Da Enquete The options available in the poll. Must be between 2 and 12 unique choices. Each option is a string representing one poll choice.

Note: There is also a notice property reminding that the poll must have at least 2 and at most 12 unique options.

Output

The node outputs a JSON array containing the response from the Zappfy API after attempting to send the poll. The exact structure depends on the API response but typically includes confirmation details such as message ID, status, or error information if the sending failed.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Zappfy API.
  • Needs an API authentication credential configured in n8n (referred generically as an API key or token).
  • Network access to https://docs.zappfy.io/api-reference base URL (the documented API endpoint).

Troubleshooting

  • Operation not supported error: If the node throws an error stating the operation is not supported, verify that the resource is set to "messages-api" and the operation to "send-poll".
  • Invalid options count: Ensure that the poll options are at least 2 and no more than 12 unique entries; otherwise, the API may reject the request.
  • Authentication errors: Confirm that the API credentials are correctly configured and valid.
  • Recipient format issues: The recipient number must be in the correct format expected by the Zappfy API; invalid formats may cause failures.
  • Network or API downtime: Check network connectivity and Zappfy API status if requests fail unexpectedly.

Links and References

Discussion