Skip to main content
An intent is a topic-level descriptor-a single world or short phrase-that reflects the customer’s main issue or question at the beginning of a conversation. Intents come out-of-the-box with support for common intents, but can be customized to match your unique use cases. Intents enable you to optimize operations by analyzing contact reasons, better route conversations, and contribute to your larger analyzing activities.

​
How it works

To help understand how intent identification works, let’s use an example conversation:
Agent: Hello, thank you for contacting XYZ Insurance. How can I assist you today?
Customer: Hi, I want to check the status of my payout for my claim.
Agent: Sure, can you please provide me with the claim number?
Customer: It’s H123456789.
Agent: Thank you. Could you also provide the last 4 digits of your account number?
Customer: 6789
Agent: Let me check the details for you. One moment, please.
Agent: I see that your claim was approved on June 10, 2024, for $5000. The payout has been processed.
Customer: Great! When will I receive the money? /autosummary/getting-started#salesforce-plugin Agent: The payout will be credited to your account within 3-5 business days.
Customer: Perfect, thank you so much for your help.
Agent: You’re welcome! Is there anything else I can assist you with?
Customer: No, that’s all. Have a nice day.
Agent: You too. Goodbye!
AI Summary analyzes the conversation, focusing primarily on the initial exchanges, to determine the customer’s main reason for contact. This is represented by the name of the intent and the code, a machine readable identifier for that intent. In this case, the intent might be identified as: 
{
  "code": "Payouts",
  "name": "Payouts"
}
The intent is determined based on the customer’s initial statement about checking the status of their payout, which is the primary reason for their contact.

​
Generate an Intent

To generate an intent, provide the conversation transcript to ASAPP. This example uses our Conversation API to provide the transcript, but you have options to use AI Transcribe integration if you have voice conversations you want to send to ASAPP.

​
Step 1: Create a conversation

To create a conversation, provide your IDs for the conversation and customer. 
curl -X POST 'https://api.sandbox.asapp.com/conversation/v1/conversations' \
--header 'asapp-api-id: <API KEY ID>' \
--header 'asapp-api-secret: <API TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
  "externalId": "[Your id for the conversation]",
  "customer": {
    "externalId": "[Your id for the customer]",
    "name": "customer name"
  },
  "timestamp": "2024-01-23T11:42:42Z"
}'
A successfully created conversation returns a status code of 200 and a conversation ID.

​
Step 2: Add messages

You need to add the messages for the conversation. You have the choice to add a single message for each turn of the conversation, or can upload a batch of messages a conversation. 
curl -X POST 'https://api.sandbox.asapp.com/conversation/v1/conversations/01HNE48VMKNZ0B0SG3CEFV24WM/messages' \
--header 'asapp-api-id: \<API KEY ID\>' \
--header 'asapp-api-secret: \<API TOKEN\>' \
--header 'Content-Type: application/json' \
--data '{ 
  "text": "Hello, I would like to upgrade my internet plan to GOLD.",
  "sender": {   
    "role": "customer",
    "externalId": "\[Your id for the customer\]" 
  },
  "timestamp": "2024-01-23T11:42:42Z"
}'
A successfully created message returns a status code of 200 and the id of the message.
We only show one message as an example, though you would create many messages over the source of the conversation.

​
Step 3: Generate Intent

With a conversation containing messages, you can generate an intent. To generate the intent, provide the ID of the conversation: 
curl -X GET 'https://api.sandbox.asapp.com/autosummary/v1/intent/5544332211' \
--header 'asapp-api-id: <API KEY ID>' \
--header 'asapp-api-secret: <API TOKEN>'
A successful intent generation returns 200 and the intent: 
{
  "conversationId": "5544332211",
  "intent": {
    "code": "Payouts",
    "name": "Payouts"
  }
}
This intent represents the primary reason for the customer’s contact, regardless of the number of agents involved in the conversation.

​
Customization

AI Summary allows for extensive customization of the intent identification to meet your specific needs. Whether you want to use industry-specific intents or adhere to your company’s unique categorization, this feature provides the flexibility to tailor intents in a way that aligns with your operational goals. To customize your intents, you can use the Self-Service Configuration tool in ASAPP’s AI Console. This tool allows you to:
  1. Upload, create, or modify intent labels
  2. Expand intent classifications by adding as many intents as needed
  3. Configure the system to align with your specific operational requirements
For more advanced customization, work with your ASAPP account team to refine and implement a custom set of intents that perfectly suit your business needs.