Start with Ipster today

Ipster answers questions, requests and appointments directly through your connected system. 24/7 availability for your business.

Custom webhook

An agent that calls your own system

With a custom webhook the agent calls the address of your own API at the moment the conversation calls for it. This lets you connect almost any system that has an HTTP endpoint, even if Ipster has no ready-made connection for it.

Ipster and your system, directly connected

What the agent does

What the agent does with your webhook

You decide what the webhook does and when the agent uses it. This works for phone and for chat.

Call your system

The agent calls the address of your own API at the right moment in the conversation. You choose the method: GET, POST, PUT, PATCH or DELETE.

Send details along

The agent sends what your system needs, such as an order number the customer mentions. You send fixed values along without the agent seeing them.

Use details from the conversation

What is already known in the conversation, such as the caller's number or something the agent recorded earlier, can be filled in the URL, the headers and the parameters.

Use the answer

The agent reads the answer from your system and tells the customer what they need, for example the status of an order.

Keep a detail from the answer

A field from the answer can be stored as a variable, so a next connection or the prompt can use it in the same conversation.

Try again after a failure

If your system gives a temporary error or the connection stalled, Ipster tries again.

What a call looks like

From question to answer from your own system

  1. 1

    Your customer calls or chats

    Ipster takes the conversation and hears what the customer needs.

  2. 2

    The agent gathers what is needed

    It asks for the details your system needs, such as an order number.

  3. 3

    Your system answers

    The agent calls your API address and gets the answer back.

  4. 4

    The agent passes it on

    It uses the answer to help the customer further.

A call to your system

  • Request · By Ipster

    To your API address

  • Answer · By Ipster

    Back to the agent

  • Variable · By Ipster

    Kept for the rest of the conversation

You decide

You stay in control

Set up the call

Choose the method, add headers for security and decide which details the agent sends along.

Decide when it may run

With requirements, the webhook only runs when something is true, for example that the customer was found first. If not, the agent gets an error message instead of the action running.

Decide how it sounds

The agent can say a short phrase while it waits for your system, like "let me check for you". Leave that empty and it works silently in the background.

How to connect it

Connected in three steps

01

Enter the address

Enter the URL of your API and choose the method, for example GET or POST.

02

Describe the connection

Give the webhook a name and a description, so the agent knows when to use it, and choose which details it sends along.

03

Tell it in the prompt

Explain to the agent at which moment in the conversation it calls the webhook.

Test your webhook first with a tool such as Postman, before you connect it to an agent.

Frequently asked questions

About the custom webhook

Any system that has an HTTP endpoint. The agent calls the address you enter, for example to look up orders in your own system.

You decide which parameters the agent sends. It can fill them in itself based on the conversation, or you send a fixed value that it does not see. Details that are already known in the conversation, such as the caller's number, can also be filled in.

You add headers, for example an Authorization header with your key. If you build the connection through the chat, you enter your API key in a secure form.

Yes. You give the goal and the link to your system's API documentation. The chat reads the documentation and proposes the connection.

On a temporary error or a connection that stalled, Ipster tries again. By default Ipster waits up to ten seconds for an answer.

Yes. The custom webhook works for phone agents and for chat agents.

Let your agent call your system

Book a demo and see how Ipster calls the API address of your own system during a conversation.

We use cookies to improve the user experience, analyse website traffic and deliver personalised content. Read our cookie policy.