Eh/odoo ticket integration

integrations/odoo-helpdesk/definitions/actions/customers.ts

@@ -0,0 +1,112 @@
+import { z, ActionDefinition } from '@botpress/sdk'
+import { customerSchema } from 'definitions/schemas'
+
+export const createCustomer: ActionDefinition = {
+  title: 'Create Customer',
+  description: 'Create a new customer',
+  input: {
+    schema: z.object({
+      id: z.string().title('ID').describe('The id of the customer'),
+      email: z.string().title('Email').describe('The email of the customer'),
+      name: z.string().title('Name').describe('The name of the customer'),
+      phone: z.string().title('Phone').describe('The phone of the customer'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      odooId: z.number().title('Odoo ID').describe('The odoo id of the created customer'),
+    }),
+  },
+}
+
+export const fetchCustomerById: ActionDefinition = {
+  title: 'Fetch Customer By ID',
+  description: 'Fetch a customer by id',
+  input: {
+    schema: z.object({
+      id: z.string().title('ID').describe('The id of the customer to fetch'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      customer: customerSchema.title('Customer').describe('The fetched customer').optional(),
+    }),
+  },
+}
+
+export const fetchCustomerByOdooId: ActionDefinition = {
+  title: 'Fetch Customer By Odoo ID',
+  description: 'Fetch a customer by odoo id',
+  input: {
+    schema: z.object({
+      id: z.string().title('ID').describe('The id of the customer to fetch'),
+      odooId: z.string().title('Odoo ID').describe('The odoo id of the customer to fetch'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      customer: customerSchema.title('Customer').describe('The fetched customer').optional(),
+    }),
+  },
+}
+
+export const fetchCustomerByEmail: ActionDefinition = {
+  title: 'Fetch Customer By Email',
+  description: 'Fetch a customer by email',
+  input: {
+    schema: z.object({
+      email: z.string().title('Email').describe('The email of the customer to fetch'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      customer: customerSchema.title('Customer').describe('The fetched customer').optional(),
+    }),
+  },
+}
+
+export const updateCustomerById: ActionDefinition = {
+  title: 'Update Customer',
+  description: 'Update a customer by id',
+  input: {
+    schema: z.object({
+      id: z.string().title('ID').describe('The id of the customer to update'),
+      email: z.string().title('Email').describe('The new email of the customer').optional(),
+      name: z.string().title('Name').describe('The new name of the customer').optional(),
+      phone: z.string().title('Phone').describe('The new phone of the customer').optional(),
+    }),
+  },
+  output: {
+    schema: z.object({
+      success: z.boolean().title('Success').describe('The success of the update'),
+      error: z.string().title('Error').describe('The error message if the update failed').optional(),
+    }),
+  },
+}
+
+export const updateCustomerByEmail: ActionDefinition = {
+  title: 'Update Customer By Email',
+  description: 'Update a customer by email',
+  input: {
+    schema: z.object({
+      email: z.string().title('Email').describe('The email of the customer to update'),
+      name: z.string().title('Name').describe('The new name of the customer').optional(),
+      phone: z.string().title('Phone').describe('The new phone of the customer').optional(),
+    }),
+  },
+  output: {
+    schema: z.object({
+      success: z.boolean().title('Success').describe('The success of the update'),
+      error: z.string().title('Error').describe('The error message if the update failed').optional(),
+    }),
+  },
+}
+
+export const actions = {
+  createCustomer,
+  fetchCustomerById,
+  fetchCustomerByEmail,
+  fetchCustomerByOdooId,
+  updateCustomerById,
+  updateCustomerByEmail,
+} as const

integrations/odoo-helpdesk/definitions/actions/helpdesk.ts

@@ -0,0 +1,35 @@
+import { z, ActionDefinition } from '@botpress/sdk'
+import { helpdeskTeamSchema, stageSchema } from 'definitions/schemas'
+
+export const getHelpdeskTeams: ActionDefinition = {
+  title: 'Get Helpdesk Teams',
+  description: 'Get all helpdesk teams',
+  input: {
+    schema: z.object({}),
+  },
+  output: {
+    schema: z.object({
+      helpdeskTeams: z.array(helpdeskTeamSchema).title('Helpdesk Teams').describe('The list of helpdesk teams'),
+    }),
+  },
+}
+
+export const getStages: ActionDefinition = {
+  title: 'Get Stages',
+  description: 'Get all stages',
+  input: {
+    schema: z.object({
+      teamId: z.number().title('Team ID').describe('The id of the team to get the stages for'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      stages: z.array(stageSchema).title('Stages').describe('The list of stages'),
+    }),
+  },
+}
+
+export const actions = {
+  getHelpdeskTeams,
+  getStages,
+} as const

integrations/odoo-helpdesk/definitions/actions/index.ts

@@ -0,0 +1,10 @@
+import * as sdk from '@botpress/sdk'
+import {actions as customerActions} from './customers'
+import {actions as ticketsActions} from './tickets'
+import {actions as helpdeskActions} from './helpdesk'
+
+export const actions = {
+  ...customerActions,
+  ...ticketsActions,
+  ...helpdeskActions,
+} as const satisfies sdk.IntegrationDefinitionProps['actions']

integrations/odoo-helpdesk/definitions/actions/tickets.ts

@@ -0,0 +1,95 @@
+import { z, ActionDefinition } from '@botpress/sdk'
+import { ticketSchema } from 'definitions/schemas'
+
+export const createTicket: ActionDefinition = {
+  title: 'Create Ticket',
+  description: 'Create a new ticket',
+  input: {
+    schema: z.object({
+      name: z.string().title('Name').describe('The name of the ticket'),
+      description: z.string().title('Description').describe('The description of the ticket'),
+      teamId: z.number().min(1).title('Team ID').describe('The helpdesk team ID associated with the ticket'),
+      priority: z.enum(['0', '1', '2', '3']).title('Priority').describe('The priority of the ticket (0 is the lowest priority)').optional(),
+      customerOdooId: z.number().title('Customer Odoo ID').describe('The Odoo customer ID associated with the ticket'),
+      stageId: z.number().title('Stage ID').describe('The stage ID associated with the ticket'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      ticketId: z.number().title('Ticket ID').describe('The ID of the created ticket'),
+    }),
+  },
+}
+
+export const fetchTicketById: ActionDefinition = {
+  title: 'Fetch Ticket',
+  description: 'Fetch a ticket by id',
+  input: {
+    schema: z.object({
+      id: z.number().title('Ticket ID').describe('The id of the ticket to fetch'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      ticket: ticketSchema.title('Ticket').describe('The fetched ticket').optional(),
+    }),
+  },
+}
+
+export const fetchTicketsByCustomerId: ActionDefinition = {
+  title: 'Fetch Tickets by Customer',
+  description: 'Fetch all tickets by customer',
+  input: {
+    schema: z.object({
+      customerOdooId: z.number().title('Customer Odoo ID').describe('The Odoo customer ID associated with the ticket'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      tickets: z.array(ticketSchema).title('Tickets').describe('The list of tickets associated with the customer'),
+    }),
+  },
+}
+
+export const fetchTicketsByCustomerEmail: ActionDefinition = {
+  title: 'Fetch Tickets by Customer Email',
+  description: 'Fetch all tickets by customer email',
+  input: {
+    schema: z.object({
+      customerEmail: z.string().title('Customer Email').describe('The email of the customer'),
+    }),
+  },
+  output: {
+    schema: z.object({
+      tickets: z.array(ticketSchema).title('Tickets').describe('The list of tickets associated with the customer'),
+    }),
+  },
+}
+
+export const updateTicket: ActionDefinition = {
+  title: 'Update Ticket',
+  description: 'Update a ticket by id',
+  input: {
+    schema: z.object({
+      ticketId: z.number().title('Ticket ID').describe('The ID of the ticket to update'),
+      name: z.string().title('Name').describe('The name of the ticket').optional(),
+      description: z.string().title('Description').describe('The description of the ticket').optional(),
+      teamId: z.number().min(1).title('Team ID').describe('The helpdesk team ID associated with the ticket').optional(),
+      priority: z.enum(['0', '1', '2', '3']).title('Priority').describe('The priority of the ticket (0 is the lowest priority, 3 is the highest)').optional(),
+      stageId: z.number().title('Stage ID').describe('The stage ID associated with the ticket').optional(),
+    }),
+  },
+  output: {
+    schema: z.object({
+      success: z.boolean().title('Success').describe('The success of the update')
+    }),
+  },
+}
+
+export const actions = {
+  createTicket,
+  fetchTicketById,
+  fetchTicketsByCustomerId,
+  fetchTicketsByCustomerEmail,
+  updateTicket,
+} as const

integrations/odoo-helpdesk/definitions/index.ts

@@ -0,0 +1,4 @@
+import { actions } from './actions'
+import { states } from './states'
+
+export { actions, states }

integrations/odoo-helpdesk/definitions/schemas/customer.ts

@@ -0,0 +1,19 @@
+import { z } from '@botpress/sdk'
+
+export const customerSchema = z.object({
+  id: z.string().describe('The id of the customer').optional(),
+  odooId: z.number().describe('The Odoo ID of the customer').optional(),
+  email: z.string().describe('The email of the customer'),
+  name: z.string().describe('The name of the customer').optional(),
+  phone: z.string().describe('The phone of the customer').optional(),
+})
+
+export type Customer = z.infer<typeof customerSchema>
+
+const customerPayloadSchema = z.object({
+  email: z.string().describe('The email of the customer'),
+  phone: z.string().describe('The phone of the customer').optional(),
+  name: z.string().describe('The name of the customer').optional(),
+})
+
+export type CustomerPayload = z.infer<typeof customerPayloadSchema>

integrations/odoo-helpdesk/definitions/schemas/helpdesk-team.ts

@@ -0,0 +1,14 @@
+import { z } from '@botpress/sdk'
+
+export const helpdeskTeamSchema = z.object({
+  name: z.string().describe('The name of the helpdesk team'),
+  id: z.number().describe('The id of the helpdesk team'),
+})
+
+export type HelpdeskTeam = z.infer<typeof helpdeskTeamSchema>
+
+const helpdeskTeamPayloadSchema = z.object({
+  name: z.string().describe('The name of the helpdesk team'),
+})
+
+export type HelpdeskTeamPayload = z.infer<typeof helpdeskTeamPayloadSchema>

integrations/odoo-helpdesk/definitions/schemas/index.ts

@@ -0,0 +1,24 @@
+import { customerSchema, Customer, CustomerPayload } from './customer'
+import { helpdeskTeamSchema, HelpdeskTeam, HelpdeskTeamPayload } from './helpdesk-team'
+import { prioritySchema, Priority, PriorityPayload } from './priority'
+import { stageSchema, Stage, StagePayload } from './stage'
+import { ticketSchema, Ticket, TicketPayload, TicketResponse } from './ticket'
+
+export {
+  customerSchema,
+  helpdeskTeamSchema,
+  prioritySchema,
+  stageSchema,
+  ticketSchema,
+  Customer,
+  CustomerPayload,
+  HelpdeskTeam,
+  HelpdeskTeamPayload,
+  Priority,
+  PriorityPayload,
+  Stage,
+  StagePayload,
+  Ticket,
+  TicketPayload,
+  TicketResponse,
+}

integrations/odoo-helpdesk/definitions/schemas/priority.ts

@@ -0,0 +1,14 @@
+import { z } from '@botpress/sdk'
+
+export const prioritySchema = z.object({
+  name: z.string().describe('The name of the priority'),
+  id: z.number().describe('The id of the priority'),
+})
+
+export type Priority = z.infer<typeof prioritySchema>
+
+const priorityPayloadSchema = z.object({
+  id: z.number().describe('The id of the priority'),
+})
+
+export type PriorityPayload = z.infer<typeof priorityPayloadSchema>

integrations/odoo-helpdesk/definitions/schemas/stage.ts

@@ -0,0 +1,16 @@
+import { z } from '@botpress/sdk'
+
+export const stageSchema = z.object({
+  name: z.string().describe('The name of the stage'),
+  id: z.number().describe('The id of the stage'),
+  teamIds: z.array(z.number()).describe('The ids of the helpdesk teams that the stage belongs to'),
+})
+
+export type Stage = z.infer<typeof stageSchema>
+
+const stagePayloadSchema = z.object({
+  name: z.string().describe('The name of the stage'),
+  team_ids: z.array(z.number()).describe('The ids of the helpdesk teams that the stage belongs to'),
+})
+
+export type StagePayload = z.infer<typeof stagePayloadSchema>

integrations/odoo-helpdesk/definitions/schemas/ticket.ts

@@ -0,0 +1,33 @@
+import { z } from '@botpress/sdk'
+
+export const ticketSchema = z.object({
+  customerOdooId: z.number().describe('The Odoo customer ID associated with the ticket'),
+  id: z.number().describe('The ticket ID'),
+  name: z.string().describe('The name of the ticket'),
+  description: z.string().describe('The description of the ticket'),
+  teamId: z.number().describe('The helpdesk team ID associated with the ticket'),
+  priority: z.string().describe('The priority of the ticket').optional(),
+  stageId: z.number().describe('The stage ID associated with the ticket').optional(),
+})
+export type Ticket = z.infer<typeof ticketSchema>
+
+const ticketPayloadSchema = z.object({
+  name: z.string().describe('The name of the ticket'),
+  description: z.string().describe('The description of the ticket'),
+  team_id: z.number().describe('The helpdesk team ID associated with the ticket'),
+  priority: z.string().describe('The priority of the ticket as a string (e.g., "0", "1", "2", "3")').optional(),
+  partner_id: z.number().describe('The customer ID associated with the ticket'),
+  stage_id: z.number().describe('The stage ID associated with the ticket').optional(),
+})
+export type TicketPayload = z.infer<typeof ticketPayloadSchema>
+
+export const ticketResponseSchema = z.object({
+  id: z.number().describe('The ticket ID'),
+  name: z.string().describe('The name of the ticket'),
+  description: z.string().describe('The description of the ticket'),
+  team_id: z.tuple([z.number(), z.string()]).describe('The helpdesk team ID and name as a tuple [id, name]'),
+  priority: z.string().describe('The priority of the ticket as a string (e.g., "0", "1", "2", "3")').optional().nullable(),
+  partner_id: z.tuple([z.number(), z.string()]).describe('The customer ID and name as a tuple [id, name]'),
+  stage_id: z.tuple([z.number(), z.string()]).describe('The stage ID and name as a tuple [id, name]').optional(),
+})
+export type TicketResponse = z.infer<typeof ticketResponseSchema>