Contentful GraphQL

Query your Contentful content with GraphQL, delivered by AI in real time

Your content model lives in Contentful. Your AI agent runs GraphQL queries against it during live conversations, pulling blog posts, product descriptions, FAQ entries, and any content type you have modeled. Visitors get precise, structured answers sourced directly from your CMS.

Get started for freeSchedule a Demo
Chosen by 800+ global brands across industries

GraphQL content queries your agent runs live

Your AI agent sends real GraphQL queries to Contentful's Content API, fetching exactly the fields and entries needed to answer each customer question with precision.

Execute GraphQL Queries

A visitor asks about your pricing tiers. Your AI agent sends a GraphQL query to Contentful's Content API targeting your pricing content type, retrieves the exact fields needed, and presents current plan details instantly.

Run Persisted Queries

For frequently asked questions, your agent executes pre-registered persisted queries by SHA256 hash. This reduces payload size, bypasses the 8KB query limit, and returns cached results faster than ad-hoc queries.

Retrieve CMA Tokens

When your agent needs to perform management operations alongside content reads, it retrieves a Content Management API token dynamically, ensuring authenticated access without hardcoding credentials into workflows.

Query Across Environments

A content reviewer asks to preview draft content. Your agent targets the staging environment ID in its GraphQL query, pulling unpublished entries from the preview API so reviewers see exactly what will go live.

Resolve Cross-Space Content

Your product catalog lives in one Contentful space while marketing copy sits in another. Your agent uses the resource_resolution parameter to resolve cross-space references, combining data from up to four spaces in a single query.

Pass Query Variables

A customer asks about a specific blog post by title. Your agent sends a parameterized GraphQL query with the title as a variable, fetching only the matching entry rather than scanning your entire content library.

Contentful GraphQL

Use Cases

CMS-powered conversations in action

Real scenarios where AI pulls structured content from Contentful via GraphQL, turning your CMS into a live knowledge base for customer interactions.

Product Information That Never Goes Stale

A prospect asks 'What features are included in your Pro plan?' Your AI Agent runs a GraphQL query against your Contentful pricing content type, fetching the Pro plan's feature list, price, and comparison notes. Because it queries live CMS data, the answer reflects the update your marketing team published ten minutes ago. No manual chatbot retraining required.

Help Articles Served From Your CMS

A customer messages 'How do I reset my API key?' Your AI Agent executes a persisted GraphQL query that searches your Contentful help center content type by topic. It returns the relevant article body and step-by-step instructions directly in the chat. Your support team wrote the article once in Contentful, and the agent serves it everywhere.

Draft Content Review Without Dashboard Access

An editor asks the AI agent to preview an unpublished blog post before it goes live. The agent targets the Contentful preview environment, runs a GraphQL query with the entry slug as a variable, and returns the draft title, body, and author. The editor reviews content from their phone on WhatsApp without logging into the CMS dashboard.

Try
Contentful GraphQL

Contentful GraphQL

FAQs

Frequently Asked Questions

How does the AI agent construct GraphQL queries against my Contentful schema?

Contentful automatically generates a GraphQL schema based on your content types. The agent uses predefined query templates mapped to common customer questions, inserting variables like entry IDs or slugs as needed. You can also register persisted queries by SHA256 hash for frequently used patterns.

What is the difference between the Contentful REST integration and this GraphQL integration?

The REST integration (Contentful OAuth) provides space-level management operations like listing and updating spaces. This GraphQL integration queries actual content entries, assets, and fields within your spaces. Use REST for CMS administration and GraphQL for content delivery to end users.

Can the agent access unpublished draft content through the preview API?

Yes. By providing a Content Preview API (CPA) access token instead of a Content Delivery API (CDA) token, the agent can query draft and changed content. This is useful for content review workflows where editors want to preview entries before publishing.

What are persisted queries and when should I use them?

Persisted queries are pre-registered GraphQL queries identified by their SHA256 hash. The agent sends only the hash and variables instead of the full query text, reducing network payload and enabling queries that exceed the 8KB size limit. Use them for complex or frequently executed queries to improve performance.

Does the agent support cross-space content references in Contentful?

Yes. The GraphQL query endpoint accepts a resource_resolution parameter (Base64-encoded JSON) that maps cross-space links. Your agent can resolve references across up to four Contentful spaces in a single query, combining product data from one space with marketing copy from another.

How do I authenticate the Contentful GraphQL integration?

You provide two credentials in the Tars dashboard: your Contentful Space ID and an API Access Token. The token is sent as a bearer token with each GraphQL request. Use a CDA token for published content or a CPA token for draft previews. Tokens are stored securely and never exposed in conversations.

Does Tars store or cache my Contentful content?

No. Every query is executed live against Contentful's GraphQL API at graphql.contentful.com. Content entries, fields, and assets are fetched in real-time for each conversation. This means answers always reflect your latest published content without any cache delay or stale data.

Can the agent query content in multiple languages from Contentful?

Yes. Contentful's GraphQL API supports locale parameters. Your agent can specify a locale variable in the query to retrieve content in the customer's language. If your content types are localized across English, Spanish, French, or any other locale, the agent fetches the matching translation.

How to add Tools to your AI Agent

Supercharge your AI Agent with Tool Integrations

Don't limit your AI Agent to basic conversations. Watch how to configure and add powerful tools making your agent smarter and more functional.

Real results, real customers, real stories

Get started for free
“We're saving an average of 4,000+ calls a month.”
Implementing an Agent revolutionized our customer service channels and our service to Indiana business owners. We're saving an average of 4,000+ calls a month and can now provide 24x7x365 customer service️ along with our business services.
Lindsey Roark Mayes
Ex-Director of SOS IT (State of Indiana)
“Cutting down on staff needing to email back.”
Since our launch of Tars Agents, we've had more than 5k interactions with them from individuals on the website. We saw prospects interacting with the Agent regarding application timelines, tuition, curriculum, and other items that may come through an email. This provides another avenue of access to our team while cutting down on staff needing to email back.
Levi Eastwood
Marketing Director of UCI Merage School
“Powerful tool - and there's so much more still to explore!”
I love the flexibility of the TARS chatbot design tool. The ability to drop in a new gambit and easily de-link and re-link gambits before and after it saves HOURS of time lost if I had to regenerate from scratch. TARS stands out for its flexibility, consistent performance, and outstanding support.
Aaron Rittmaster
Founder
“I like the product.”
Takes those boring forms and allows you to make the collecting of customer information enjoyable for the user. It has a lot of value and I see the company constantly working on improving it.
Pierre Rattini
Director of Marketing
“Very responsive and supportive Team”
I love how supportive and responsive the team members are. The chatbots are not difficult to build once you have an idea of what you are doing, and this is so based on the backend work Tars has completed. Also, they are flexible to the clients' requests.
Keisha Cameron
Product Manager
“Easy for cooperation and open to agreement.”
One of the biggest qualities of TARS is their ability to truly understand their clients' needs. They took the time to thoroughly assess our requirements, offering valuable insights and recommendations that we hadn't even considered. This level of personalized attention made a significant difference in the success of our project.
Milica Petrovic
Customer Care Project Associate
“Great service”
The guys at Tars are so passionate about bots and maximum engagement. Tars is overall a great product with really nice people there to help me engage and automate conversations I would have otherwise missed.
Nigel Gosling
Health Coach
“Best in class for lead generation”
TARS is an essential tool within our lead gen strategy. I started to use it a couple years ago, and the platform evolved to focus on results. You can integrate your Google Analytics, Facebook Pixel, and AdWords conversion tag to track results and measure your campaign. You can also integrate with Zapier, which opens a lot of possibilities. Compared with static landing pages, we have seen an increase in conversions and more engagement.
Leonardo Wolff
Founder
“Very professional and cooperative”
Building an automated chat that our customers actually used and reduced calls amount.
Maryam Alhaddad
Customer Journey Designer
“Flexibility and good service”
Tars platform is very flexible, so you can do pretty much any flux you desire. Also integrates with any third party through APIs with a very simple and easy-to-use interface. Also tars team is great! Always at disposal and brings suggestions and solutions for any issue encountered during the process of building the chatbot.
Lucas Von Lachmann
Process Manager
“Deserved The title of the Best Chatbot of the Year”
If you are building chatbots, you cannot go wrong with TARS. I have been with this company since their beginning. Seen how they have grown. I have tested a lot of bots, but this one is still the best out there. We use WhatsApp a lot for our business. And what I like best is that I can have 1 chatbot for website and for my WhatsApp. I especially appreciate their support team as well. Whenever I am stuck, they quickly reply to my questions.
MJ Felix
Chairman
“Advanced integration, easy to use, and very customizable.”
This chatbot does everything from AI integration to complete customization and is excellent for lead conversion in most industries. I think the pre-formatted templates are an excellent boost to get started quickly. The team is also excellent.
Rachel Rowling
Chief Operating Officer
“The chatbot implementation has exceeded expectations!”
The implementation has delivered 24/7 customer support and is proving its value by reducing Contact center calls by around 5% in just four months of operation. Beyond enhancing the e-care experience, the chatbot is driving impressive business results, achieving a remarkable 20% month-on-month growth.
Victor Pereira
Customer Care and CX Manager
“We're saving an average of 4,000+ calls a month.”
Implementing an Agent revolutionized our customer service channels and our service to Indiana business owners. We're saving an average of 4,000+ calls a month and can now provide 24x7x365 customer service️ along with our business services.
Lindsey Roark Mayes
Ex-Director of SOS IT (State of Indiana)
“Cutting down on staff needing to email back.”
Since our launch of Tars Agents, we've had more than 5k interactions with them from individuals on the website. We saw prospects interacting with the Agent regarding application timelines, tuition, curriculum, and other items that may come through an email. This provides another avenue of access to our team while cutting down on staff needing to email back.
Levi Eastwood
Marketing Director of UCI Merage School
“Powerful tool - and there's so much more still to explore!”
I love the flexibility of the TARS chatbot design tool. The ability to drop in a new gambit and easily de-link and re-link gambits before and after it saves HOURS of time lost if I had to regenerate from scratch. TARS stands out for its flexibility, consistent performance, and outstanding support.
Aaron Rittmaster
Founder
“I like the product.”
Takes those boring forms and allows you to make the collecting of customer information enjoyable for the user. It has a lot of value and I see the company constantly working on improving it.
Pierre Rattini
Director of Marketing
“Very responsive and supportive Team”
I love how supportive and responsive the team members are. The chatbots are not difficult to build once you have an idea of what you are doing, and this is so based on the backend work Tars has completed. Also, they are flexible to the clients' requests.
Keisha Cameron
Product Manager
“Easy for cooperation and open to agreement.”
One of the biggest qualities of TARS is their ability to truly understand their clients' needs. They took the time to thoroughly assess our requirements, offering valuable insights and recommendations that we hadn't even considered. This level of personalized attention made a significant difference in the success of our project.
Milica Petrovic
Customer Care Project Associate
“Great service”
The guys at Tars are so passionate about bots and maximum engagement. Tars is overall a great product with really nice people there to help me engage and automate conversations I would have otherwise missed.
Nigel Gosling
Health Coach
“Best in class for lead generation”
TARS is an essential tool within our lead gen strategy. I started to use it a couple years ago, and the platform evolved to focus on results. You can integrate your Google Analytics, Facebook Pixel, and AdWords conversion tag to track results and measure your campaign. You can also integrate with Zapier, which opens a lot of possibilities. Compared with static landing pages, we have seen an increase in conversions and more engagement.
Leonardo Wolff
Founder
“Very professional and cooperative”
Building an automated chat that our customers actually used and reduced calls amount.
Maryam Alhaddad
Customer Journey Designer
“Flexibility and good service”
Tars platform is very flexible, so you can do pretty much any flux you desire. Also integrates with any third party through APIs with a very simple and easy-to-use interface. Also tars team is great! Always at disposal and brings suggestions and solutions for any issue encountered during the process of building the chatbot.
Lucas Von Lachmann
Process Manager
“Deserved The title of the Best Chatbot of the Year”
If you are building chatbots, you cannot go wrong with TARS. I have been with this company since their beginning. Seen how they have grown. I have tested a lot of bots, but this one is still the best out there. We use WhatsApp a lot for our business. And what I like best is that I can have 1 chatbot for website and for my WhatsApp. I especially appreciate their support team as well. Whenever I am stuck, they quickly reply to my questions.
MJ Felix
Chairman
“Advanced integration, easy to use, and very customizable.”
This chatbot does everything from AI integration to complete customization and is excellent for lead conversion in most industries. I think the pre-formatted templates are an excellent boost to get started quickly. The team is also excellent.
Rachel Rowling
Chief Operating Officer
“The chatbot implementation has exceeded expectations!”
The implementation has delivered 24/7 customer support and is proving its value by reducing Contact center calls by around 5% in just four months of operation. Beyond enhancing the e-care experience, the chatbot is driving impressive business results, achieving a remarkable 20% month-on-month growth.
Victor Pereira
Customer Care and CX Manager

Privacy & Security

We’ll never let you lose sleep over privacy and security concerns

At Tars, we take privacy and security very seriously. We are compliant with GDPR, ISO, SOC 2, and HIPAA.

GDPR
ISO
SOC 2
HIPAA

Still scrolling? We both know you're interested.

Let's chat about AI Agents the old-fashioned way. Get a demo tailored to your requirements.

Schedule a Demo
Get in touch

Email - sales@hellotars.com

Get in touch.

Email - sales@hellotars.com

Company
About usTerms and ConditionsPrivacy PolicyContact usCareers
Resources
Case StudiesBlogHelp DocsPartner ProgramCommunityChatbot Templates
Product
Knowledge HubToolsCategorizerConversational AIAI AnalyticsAI Evaluation
USE CASES
Finance & BankingInsuranceGovernmentHealthcareTelecom
© 2025 Copyright Tars Technologies Inc.