Events

Events are all conversation and workflows executed through the agent.

These can be individual sessions between either agent and user or actions performed by the agent (like sending a text message or email, or API request). Events can be triggered fully separate from one another.

For WhatsApp agents, we currently offer three event types:

  • Inbound session

  • Outbound session

  • API Event

Event Types

Inbound Session

Use this event within your agent if you want your users to be able to start the conversation with the agent. This is helpful in cases where you want your agent to be able to answer FAQ’s, book appointments, etc.

There are no node restrictions on nodes used in the flow.

Note, that you can only create one inbound event per agent.

Outbound Session

This event can be used when you want the agent to have the first word and reach out to your users. This is helpful for reminders, informational campaigns etc. You can either integrate into your database and set up a trigger for Studio or trigger an outbound WhatsApp agent.

Are you within the limits?

Studio’s outbound call limits that is! We currently only allow one session per second however if your virtual agent needs to make more calls we can increase the limit up to 5 outbound sessions per second.

If you require an increased limit, please email ai.support@vonage.com with the following details:-

  • API key

  • Agent ID(/s)

  • Increase request: You can choose to increase your limit to 3 or 5 sessions per second

Once you receive confirmation from our teams that your request has been processed, please publish your agents and wait for about 5 minutes before you start triggering any new outbound sessions.

Please note that if your agent is not approved for a higher limit, any call made over the 1 call per second limit will fail and return a 429 error!

API Event

The API event flow will be triggered by an incoming API call. This HTTP-event-based flow can be initialized at any time completely separate from the main flow from an API call platform such as Postman.

Use Case Example: A customer inquires about a certain product. The customer's database receives that information and uses this event to trigger an email with discount opportunities to the customer.

To initiate this event, click on the node, copy the endpoint and all other request parameters to your API platform of choice.

You can only use action-based nodes for this event, e.g. webhooks, custom code, etc.

You can create multiple API events per agent.

Last updated