Kustomer
Authentication Type: API Key
Description: Customer service platform for managing conversations, creating custom objects, and pushing personalization data.
Notes
Add notes to Kustomer conversations for tracking personalization insights and customer interactions.
Add Note to Conversation
Add a note to a Kustomer conversation.
Operation Type: Mutation (Write)
Parameters:
- conversationId
string
(required): ID of the conversation to add the note to - noteBody
string
(required): Content of the note to add - isInternal
boolean
(required): Whether the note is internal (not visible to customer). Defaults to true
Returns:
- success
boolean
: Whether the note was added successfully - noteId
string
: ID of the created note (empty string if not available)
Example Usage:
{
"conversationId": "conv_12345abc",
"noteBody": "Customer showed interest in premium features during this conversation. Recommended upgrade to Pro plan based on their usage patterns and feature requests.",
"isInternal": true
}
Custom Objects
Create custom objects in Kustomer with personalization data and customer associations.
Create Custom Objects
Create custom objects in Kustomer with personalization data.
Operation Type: Mutation (Write)
Parameters:
- klassName
string
(required): Name of the Klass to create objects for - objects
array of objects
(required): Array of objects to create- title
string
: Title/name for the object - customerId
string
: ID of the customer to associate with (use empty string if not applicable) - data
array of objects
: Custom data fields as key-value pairs- key
string
: Field name - value
string
: Field value
- key
- title
- fieldTypes
array of objects
(required): Field type mappings as key-value pairs- key
string
: Field name - value
string
: Field type (txt, str, num, bool, date)
- key
Returns:
- success
boolean
: Whether objects were created successfully - createdCount
number
: Number of objects successfully created - objectIds
array of strings
: IDs of the created objects
Example Usage:
{
"klassName": "Customer_Preferences",
"objects": [
{
"title": "John Smith Preferences",
"customerId": "cust_abc123",
"data": [
{
"key": "preferred_contact_method",
"value": "email"
},
{
"key": "product_interest_score",
"value": "8.5"
},
{
"key": "last_interaction_date",
"value": "2024-01-15"
},
{
"key": "is_premium_customer",
"value": "true"
}
]
}
],
"fieldTypes": [
{
"key": "preferred_contact_method",
"value": "str"
},
{
"key": "product_interest_score",
"value": "num"
},
{
"key": "last_interaction_date",
"value": "date"
},
{
"key": "is_premium_customer",
"value": "bool"
}
]
}
Klasses
Create Kustomer Klasses (custom data schemas) for defining personalization data structures. Note: Attributes must be added manually through the Kustomer UI.
Create Custom Klass
Create a new custom Klass definition in Kustomer. Attributes must be added manually through the UI.
Operation Type: Mutation (Write)
Parameters:
- name
string
(required): Name of the Klass (must be unique in your organization) - displayName
string
(required): Human-readable display name for the Klass - description
string
(required): Description of what this Klass represents (use empty string if not applicable) - icon
string
(required): Icon identifier for the Klass (use empty string if not applicable)
Returns:
- success
boolean
: Whether the Klass was created successfully - klassId
string
: ID of the created Klass - name
string
: Name of the created Klass - note
string
: Additional information about the creation
Example Usage:
{
"name": "Purchase_History",
"displayName": "Customer Purchase History",
"description": "Tracks customer purchase patterns, preferences, and transaction history for personalization",
"icon": "shopping-cart"
}
Customer Data
Update customer records with personalization data.
Update Customer Data
Update customer with personalization data.
Operation Type: Mutation (Write)
Parameters:
- customerId
string
(required): ID of the customer to update - personalizationData
array of objects
(required): Personalization data as key-value pairs- key
string
: Data field name - value
string
: Data field value
- key
Returns:
- success
boolean
: Whether customer was updated successfully - customerId
string
: ID of the updated customer
Example Usage:
{
"customerId": "cust_abc123",
"personalizationData": [
{
"key": "communication_preference",
"value": "email_only"
},
{
"key": "preferred_language",
"value": "spanish"
},
{
"key": "loyalty_tier",
"value": "gold"
},
{
"key": "last_purchase_category",
"value": "electronics"
},
{
"key": "support_priority_level",
"value": "high"
}
]
}
Common Use Cases
Personalized Customer Support:
- Add detailed notes to conversations with customer preferences, issues, and resolution context for future reference
- Update customer records with personalization data like communication preferences, product interests, and support history
- Create custom objects to track customer journey milestones, satisfaction scores, and engagement patterns
Customer Data Organization:
- Create custom Klasses to define structured data schemas for different types of customer information
- Store complex customer data in custom objects with proper field typing and customer associations
- Organize personalization data across multiple touchpoints and interaction channels for comprehensive customer profiles
Support Workflow Enhancement:
- Track internal notes on customer interactions to improve support quality and consistency across team members
- Associate custom data objects with specific customers to provide context-rich support experiences
- Update customer profiles with real-time personalization data from various business systems and touchpoints
Business Intelligence and Analytics:
- Create structured data objects for tracking customer behavior patterns, preferences, and satisfaction metrics
- Store personalization insights in custom Klasses for analysis and reporting across customer segments
- Maintain comprehensive customer data records for predictive analytics and personalized marketing campaigns