WibiClick icon

WibiClick

Interact with WibiClick API
Join our community

Actions92

Overview

This node integrates with the WibiClick API to manage various resources, including jobs. Specifically, for the Job - Create operation, it allows users to create a new job entry associated with a specified website. This is useful in scenarios where you want to automate job creation workflows, such as scheduling service calls, managing work orders, or tracking tasks related to customers and employees.

For example, a field service company could use this node to automatically create jobs when a customer submits a request via a web form, assigning details like address, issue description, assigned employee, and scheduled time slots.

Properties

Name Meaning
Website ID The unique identifier of the website under which the job will be created.
Job Data A collection of fields describing the job details:
   Address Physical address where the job is to be performed.
   Callout Callout information related to the job (e.g., special instructions).
   Customer ID Identifier of the customer associated with the job.
   Employee ID Identifier of the employee assigned to the job.
   Issue Description of the issue or reason for the job.
   Location Location details for the job (may differ from address).
   Name Name or title of the job.
   Phone Contact phone number related to the job.
   Slot End Date and time marking the end of the job's scheduled slot.
   Slot Start Date and time marking the start of the job's scheduled slot.

Output

The output JSON object contains the response from the WibiClick API after creating the job. It typically includes the newly created job's details such as its ID and all submitted fields, confirming successful creation.

Example output structure:

{
  "id": "job-unique-id",
  "address": "123 Main St",
  "callout": "Urgent",
  "customerId": "customer-uuid",
  "employeeId": "employee-uuid",
  "issue": "Leaking pipe",
  "location": "Building A",
  "name": "Fix plumbing",
  "phone": "+1234567890",
  "slotEnd": "2024-06-30T15:00:00Z",
  "slotStart": "2024-06-30T13:00:00Z"
}

No binary data is output by this operation.

Dependencies

  • Requires an active connection to the WibiClick API.
  • Requires an API key credential configured in n8n for authentication.
  • The node uses HTTP POST requests to send job data to the endpoint /add-job?id={websiteId}.

Troubleshooting

  • Missing Required Fields: Ensure that the Website ID and at least some job data fields are provided; otherwise, the API may reject the request.
  • API Authentication Errors: If the API key is invalid or missing, the node will fail to authenticate. Verify the API key credential configuration.
  • Network Issues: Connectivity problems can cause request failures. Check network access to the WibiClick API URL.
  • Invalid Date Formats: For slotStart and slotEnd, ensure valid ISO 8601 date-time strings are used.
  • Unexpected API Responses: If the API returns an error or unexpected response, check the API documentation or contact support.

Links and References

Discussion