alpha

Create customer cases

Open a customer case: a new Alpha conversation beside a customer surface, bound to what it works. kind customer_edit is Bulk edit's chat over the selected customers (customerIds: any number of any of the organization's business profiles, each once, in the grid's order; no businessProfileId), held by id; its turns read the customers through Business's operations as the member and propose changes only through business_customer_edit_reviews_create_v5. kind customer_describe is Describe's chat about count new customers of one business profile (no customerIds); its turns read the group they describe only through business_customer_descriptions_create_v3. Returns the case and its conversation: send its turns with alpha_conversations_send (threadId is conversationId). Its turns never save or add a customer and are included, drawing no Alpha credits; the conversation is left out of alpha_conversations_list, and alpha_customer_cases_get names the review or description it last requested. A retry with the same idempotency key returns the same case. Needs a signed-in member.

post/api/v1/alpha/customer-cases/create

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/alpha/customer-cases/create
  • Auth: OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Idempotency-Keystring uuid required

UUID naming this intent. Retry with the same key; reuse for other input is 409.

Request body

kind'customer_edit' | 'customer_describe' | 'crm_import' required

customer_edit for Bulk edit's selected customers, customer_describe for the new customers Describe adds, crm_import for a CRM upload's column mapping

businessProfileIdstring uuid

customer_describe and crm_import only: the business profile the new customers, or the upload's rows, are added to

customerIdsstring[]

customer_edit only: the selected customers' ids, of any of the organization's business profiles, in the grid's order, each once

countinteger

customer_describe only: how many new customers the case describes

namestring

crm_import only: the upload's name

rowCountinteger

crm_import only: how many rows the upload's file holds

mappingVersionIdstring uuid

crm_import only: the saved CSV mapping version the case opens on (business_crm_mapping_versions_create_v2's version.id)

Response

Success.

caseIdstring uuid required
conversationIdstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.