Skip to main content

Hi Intercom Community,

I need help understanding a couple of things about  "Next Response Time" (NRT):

  1. How is NRT calculated? Is it based on each customer message and team response after the initial reply, and how does Intercom determine if it's "hit" or "missed"?

  2. Can I calculate NRT from the API? I don't see specific fields in the conversation object for NRT. Is there a way to derive it from available data (like time_to_admin_reply or median_time_to_reply)?

Any insights on tracking NRT via the API or understanding the SLA logic would be greatly appreciated!

Thanks,

Hey @360dialog Team 👋

The Next Response Time (NRT) in Intercom is calculated after the First Response Time (FRT) is hit or missed. Once the initial response has been made, the NRT starts and will show as missed if the time frame set for the next response lapses without a reply. You can use a view to filter your conversations by SLA, which will include NRT, to have a centralized view of all conversations that have missed their SLA targets.

You can calculate the median first response time (FRT) for conversations assigned to a team using the Intercom API with these steps:

  • Filter conversations by team_assignee_id.

  • Use the total_count to find the total number of conversations.

  • Retrieve the statistics.first_admin_reply_at value for each conversation.

  • Calculate the median of these values to determine the median FRT by team assigned.

This process will give you the median time it takes for your team to reply to the first incoming message in a conversation. Remember, this is the median time across all conversations, not the FRT for an individual conversation. If you need to search for conversations within a specific date range and by team assignee ID, you can use the provided JSON query structure in the API documentation.

 

For more detailed guidance on using the Conversations API, you can refer to the Conversations API documentation. Additionally, you can build custom reports using the API by searching for conversations with specific attributes, such as team_assignee_id, and retrieving relevant metrics like statistics.first_admin_reply_at for each conversation. Check out this Community post for more on this.

 


Hi @bernice,

Thanks for your explanation.
I just want to clarify: while I totally understand how to calculate the First Response Time (FRT) via the API - and in general how to derive all the metrics - is still unclear to me how to extract the Next Response Time (NRT) from the conversation schema via the API.

Since I don't see a specific field for NRT in the conversation object, could you please explain how we can derive or calculate NRT using available data from the API? Since for FRT I’m using statistics.first_admin_reply_at, I was expecting something similar, like statistics.next_reply_at. Are there particular fields we should be using to determine the absolute value of NRT?
 

To b more clear I’m talking exclusively about this guy here. I would like extract the data from the api to gain those same numbers on our end. 
Thanks again for your help!


Reply