WibiClick icon

WibiClick

Interact with WibiClick API

Actions92

Overview

This node integrates with the WibiClick API to manage various resources such as jobs, contacts, employees, invoices, and more. Specifically for the Job - Get operation, it retrieves job information associated with a particular website and contact or phone number. This is useful in scenarios where you want to fetch job details related to a specific customer or contact within a website's context.

Practical examples:

  • Fetch all jobs linked to a given contact ID on a website.
  • Retrieve jobs by the phone number of a contact if the contact ID is not known.
  • Use this data to automate workflows that depend on job status or details, such as sending notifications or updating records.

Properties

Name Meaning
Website ID The unique identifier of the website to which the job belongs.
Contact ID (Optional) The unique identifier of the contact whose jobs you want to retrieve.
Phone Number (Optional) The phone number of the contact to find jobs for, used if Contact ID is empty.

Note: Either Contact ID or Phone Number must be provided; otherwise, the node will throw an error.

Output

The output is a JSON object containing the job data retrieved from the WibiClick API for the specified contact or phone number within the given website. The structure depends on the API response but generally includes job details such as job IDs, statuses, descriptions, dates, and other relevant fields.

No binary data is output by this operation.

Example output snippet (conceptual):

{
  "jobs": [
    {
      "id": "job-id-123",
      "status": "completed",
      "description": "Fixing plumbing issue",
      "scheduledDate": "2024-06-15T09:00:00Z",
      ...
    },
    ...
  ]
}

Dependencies

  • Requires an active connection to the WibiClick API via an API key credential.
  • The node expects the API URL and API key to be configured in the credentials.
  • No additional external dependencies are required beyond the HTTP requests to the WibiClick API.

Troubleshooting

  • Error: "Either contactId or phoneNumber is required"
    This error occurs if both Contact ID and Phone Number inputs are empty. Provide at least one to proceed.

  • API Authentication Errors
    Ensure the API key credential is correctly set up and has the necessary permissions.

  • Unexpected API Response or Empty Data
    Verify that the Website ID and Contact ID/Phone Number are correct and exist in the WibiClick system.

  • Network or Timeout Issues
    Check network connectivity and API availability.

Links and References


If you need summaries for other operations or resources, feel free to ask!

Discussion