NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Plain

plain

Plain is a collaborative support platform for B2B support teams, offering a modern, AI-powered interface to consolidate support channels and assist customers efficiently.

Customer SupportWeb del proveedor
Acciones
23
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (23)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add Customer To GroupPLAIN_ADD_CUSTOMER_TO_GROUPAcción

Tool to add a customer to one or more customer groups. use when you have a customer and groups ready.

Parámetros de entrada

  • customerIdstringObligatorio

    ID of the customer to add to groups.

  • customerGroupIdentifiersobject[]Obligatorio

    List of customer group identifiers. Must contain at least one identifier.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create CustomerPLAIN_CREATE_CUSTOMERAcción

Tool to create a customer. use after gathering email and full name to provision a new customer in plain.

Parámetros de entrada

  • emailanyObligatorioemail

    Customer's unique email address

  • full_namestringObligatorio

    The full name of the customer (e.g. 'John Doe')

  • short_namestring

    An optional short name, typically the first name

  • external_idstring

    Your system's ID for idempotency (optional)

  • email_verifiedboolean

    Whether this email is already verified in Plain

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create ThreadPLAIN_CREATE_THREADAcción

Tool to create a new thread. use after obtaining valid customer identifier.

Parámetros de entrada

  • titlestringObligatorio

    Title of the new thread

  • assignedToobject

    Optional user assignment for the thread

  • componentsobject[]

    Optional list of content components for the thread

  • labelTypeIdsstring[]

    Optional list of label type IDs to assign

  • customerIdentifierobjectObligatorio

    Identifier object for the customer

Parámetros de salida

  • dataobjectObligatorio

    GraphQL response payload

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete CustomerPLAIN_DELETE_CUSTOMERAcción

Tool to delete a customer from the system. use when you need to remove a customer by their id.

Parámetros de entrada

  • customer_idstringObligatorio

    Unique identifier of the customer to delete, as returned by the Plain API.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete UserPLAIN_DELETE_USERAcción

Tool to delete a user from the system. use when you need to remove a user by their id after confirming existence.

Parámetros de entrada

  • user_idstringObligatorio

    Unique identifier of the user to delete, as returned by the Plain API.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Fetch CompanyPLAIN_FETCH_COMPANYAcción

Tool to fetch company details by id. use when you need the full profile of a company, including name, domain, contract value, owner info, and timestamps.

Parámetros de entrada

  • company_idstringObligatorio

    Plain's internal ID of the company to fetch, e.g., 'cmp_01H1P4TE62AS5KZ4CZFC0578ED'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Fetch IssuesPLAIN_FETCH_ISSUESAcción

Tool to fetch external issue links for a customer. use when you need to list all issues across a customer's threads.

Parámetros de entrada

  • linkFirstinteger

    The number of issue links to fetch per thread. Must be ≥1.

  • customerIdstringObligatorio

    The unique identifier of the customer whose issues are to be retrieved.

  • threadFirstinteger

    The number of threads to fetch for the customer. Must be ≥1.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Fetch TierPLAIN_FETCH_TIERAcción

Tool to fetch a tier by its id. use when you have a tier id and need its metadata before proceeding. example: "fetch tier with id tier 123".

Parámetros de entrada

  • tier_idstringObligatorio

    The unique identifier of the tier to fetch (e.g., 'tier_123')

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Customer By EmailPLAIN_GET_CUSTOMER_BY_EMAILAcción

Tool to fetch customer details by email. use after confirming the email exists to retrieve detailed customer information.

Parámetros de entrada

  • emailanyObligatorioemail

    Email address of the customer to fetch

Parámetros de salida

  • dataobjectObligatorio

    GraphQL response payload

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Customer By IDPLAIN_GET_CUSTOMER_BY_IDAcción

Tool to retrieve details of a specific customer by their unique id. use after obtaining the customer's id to fetch their complete record.

Parámetros de entrada

  • idstringObligatorio

    The unique identifier of the customer to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get CustomersPLAIN_GET_CUSTOMERSAcción

Tool to fetch a list of customers. use when retrieving multiple customer records with pagination, filtering, or sorting.

Parámetros de entrada

  • lastinteger

    Number of customers to fetch before the 'before' cursor. Must be ≥ 1.

  • afterstring

    Cursor for forward pagination. Use with 'first'.

  • firstinteger

    Number of customers to fetch after the 'after' cursor. Must be ≥ 1.

  • beforestring

    Cursor for backward pagination. Use with 'last'.

  • sortByobject

    Sorting instructions for the customers list.

  • filtersobject

    Filters to apply when fetching customers.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Thread By IDPLAIN_GET_THREAD_BY_IDAcción

Tool to fetch details of a specific thread using its unique identifier. use after confirming the thread id is correct.

Parámetros de entrada

  • idstringObligatorio

    Unique identifier of the thread to fetch

Parámetros de salida

  • dataobjectObligatorio

    GraphQL response payload

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get User By IDPLAIN_GET_USER_BY_IDAcción

Tool to fetch user by id. use when you have a valid user id to retrieve detailed user information.

Parámetros de entrada

  • user_idstringObligatorio

    Unique identifier of the user to fetch

Parámetros de salida

  • dataobjectObligatorio

    GraphQL response payload with user data

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ThreadsPLAIN_LIST_THREADSAcción

Tool to list all threads. use when you need to retrieve thread summaries with optional pagination.

Parámetros de entrada

  • lastinteger

    Number of threads to fetch before the 'before' cursor. Must be ≥ 1.

  • afterstring

    Cursor for forward pagination. Use with 'first'.

  • firstinteger

    Number of threads to fetch after the 'after' cursor. Must be ≥ 1.

  • beforestring

    Cursor for backward pagination. Use with 'last'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List TiersPLAIN_LIST_TIERSAcción

Tool to retrieve a list of tiers with pagination. use when you need to browse available tiers after determining pagination cursors. example: 'list tiers with first=25'.

Parámetros de entrada

  • lastinteger

    Number of items to fetch in backward pagination; must be ≥ 1.

  • afterstring

    Cursor for forward pagination, used together with 'first'.

  • firstinteger

    Number of items to fetch in forward pagination; must be ≥ 1.

  • beforestring

    Cursor for backward pagination, used together with 'last'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Customer GroupPLAIN_PLAIN_CREATE_CUSTOMER_GROUPAcción

Tool to create a new customer group. use when needing to group customers for segmentation. creates a new customer group with specified name, key, color, and optional externalid.

Parámetros de entrada

  • keystringObligatorio

    Unique key for the customer group

  • namestringObligatorio

    Name of the customer group

  • coloranyObligatorio

    Hex color code for the group (e.g. #FF5733)

  • externalIdstring

    Optional external ID for the customer group

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Customer GroupsPLAIN_PLAIN_LIST_CUSTOMER_GROUPSAcción

Tool to list all customer groups. use when you need to retrieve group metadata with optional pagination or filters.

Parámetros de entrada

  • lastinteger

    Number of groups to fetch before the 'before' cursor. Must be ≥ 1.

  • afterstring

    Cursor for forward pagination. Use with 'first'.

  • firstinteger

    Number of groups to fetch after the 'after' cursor. Must be ≥ 1.

  • beforestring

    Cursor for backward pagination. Use with 'last'.

  • filtersobject

    Filters to apply when fetching customer groups.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ThreadsPLAIN_PLAIN_QUERY_THREADSAcción

Tool to retrieve a paginated list of threads. use when you need to list threads with optional status filtering.

Parámetros de entrada

  • cursorstring

    Cursor for pagination returned by a previous call. Omit for first page.

  • statusesstring[]

    Filter threads by status. Supported values: TODO, SNOOZED, DONE.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Remove Customer From GroupPLAIN_REMOVE_CUSTOMER_FROM_GROUPAcción

Tool to remove a customer from one or more customer groups. use when you need to revoke memberships.

Parámetros de entrada

  • customerIdstringObligatorio

    ID of the customer to remove from groups.

  • customerGroupIdentifiersobject[]Obligatorio

    List of customer group identifiers. Must contain at least one identifier.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Send MessagePLAIN_SEND_MESSAGEAcción

Tool to send a new message within a thread. use after identifying the thread and preparing message content.

Parámetros de entrada

  • threadIdstringObligatorio

    Unique identifier of the thread to reply to

  • textContentstring

    Plain text content of the message

  • impersonationobject

    Impersonate a customer when sending the message

  • markdownContentstring

    Markdown-formatted content of the message; at least one of textContent or markdownContent is required

  • channelSpecificOptionsobject

    Channel-specific options such as email CC/BCC recipients

Parámetros de salida

  • dataobjectObligatorio

    GraphQL response payload

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update CompanyPLAIN_UPDATE_COMPANYAcción

Tool to update an existing company's details. use when modifying a company's name or domain.

Parámetros de entrada

  • namestringObligatorio

    New name for the company.

  • companyIdstringObligatorio

    Unique ID of the existing company to update.

  • domainNamestringObligatorio

    New domain name for the company (e.g., 'acme.com').

  • contractValueinteger

    Optional contract value in cents. Must be non-negative.

  • accountOwnerUserIdstring

    ID of the user to assign as account owner.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update ThreadPLAIN_UPDATE_THREADAcción

Tool to update a thread's title. use when renaming a thread after confirming its id.

Parámetros de entrada

  • titlestringObligatorio

    New title for the thread

  • threadIdstringObligatorio

    Unique identifier of the thread to update

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Upsert CustomerPLAIN_UPSERT_CUSTOMERAcción

Tool to upsert (create or update) a customer. use when syncing or ensuring a customer record exists before subsequent actions.

Parámetros de entrada

  • onCreateobjectObligatorio

    Details for creation if not found.

  • onUpdateobjectObligatorio

    Details for update if found.

  • identifierobjectObligatorio

    Selector for existing customer.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not