Fetchply Docs
Integrations

Functions — Connect External APIs to Your Free AI Chatbot

Connect your own APIs and services to your free Fetchply AI chatbot. Your chatbot calls your endpoints to fetch live data during conversations. Available on Starter+.

What Custom Functions Do

Custom functions let you connect your own external services to your agent. When a visitor asks a question that needs live data — like "What's my order status?" or "Do you have red shoes in stock?" — your agent can reach out to your own systems and answer with real information.

Think of it as giving your agent the ability to look up answers from your own tools, not just from your website content.

Where to Set Up Functions

Go to Dashboard → Agent → Settings → Integrations → Functions.

Setting Up a Function

The setup has three steps:

Describe the function

Give your function a name and describe what it does. This helps your agent know when to use it.

For example: "Look up order status" with a description like "Gets the current status of a customer's order using their order number."

Set up the request

Configure how your agent calls your service:

  • URL — the web address of your service
  • Method — GET or POST
  • Headers — any extra information your service needs (like an authorization key)
  • Parameters — the pieces of information to send (like an order number or email)

If your service needs a secret key or password for access, you can store it securely. Your keys are encrypted and never shown to anyone — not even your team.

Shape the response

Decide how the answer from your service should be shown:

  • Raw mode — the full response is passed to your agent to summarize
  • Template mode — you pick specific fields from the response to include (like order.status or order.tracking_number)

Template mode is recommended — it keeps answers focused and prevents sharing unnecessary data.

Testing a Function

Before going live, test your function from the dashboard:

  • Click Test on any saved function to try it with sample inputs
  • Or use the Test Configuration option to test settings before saving

Test runs don't affect your analytics or conversation history, so you can experiment freely.

Monitoring Function Activity

Each function has an Activity tab showing:

  • How many times the function has been called
  • Success and failure rates
  • Performance over time

This helps you spot problems and understand what your visitors are asking about.

Function Limits by Plan

PlanMax Functions
Free0
Starter1
Pro5
Business20

Security

  • All connections go over secure (encrypted) connections
  • Your secret keys are encrypted and stored safely
  • Responses are size-limited to avoid accidental data leaks
  • Your agent only sends the information you configure — nothing extra

Important Notes

  • Functions can only call secure websites (those starting with https://)
  • Calls have a time limit — if your service doesn't respond quickly enough, your agent will let the visitor know
  • Functions that fail don't break the conversation — your agent continues using its regular knowledge

Custom functions are available on Starter and higher plans. Use them to give your agent real-time access to your own data and services.