API Reference

Send AI generated answer (V2)

post
https://api.alcmeon.com/ai/v2/answer

V2 endpoint to invoke to send an AI generated answer to a social network user via bot scenario. This version supports custom exit codes and enhanced variable handling for bot scenarios. Once your AI API has been asynchronously called by Alcméon with a jwt specific for a given social network user, this endpoint can be invoked (with the jwt previously received) to send the generated answer and trigger the appropriate scenario exit.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Exit code to determine which scenario path to take. Must match one of the exit codes provided in the webhook request. Can be one of the standard exit codes (endDiscussion, continueDiscussion, escalateToHuman, error) or a custom exit code defined in the AI Agent settings.

message
required

The message to send to the social network user. Set to null if no message should be sent (e.g., when only setting variables or choosing an exit without a response). Otherwise, provide a message object with the content to send.

variables
object
required

A dictionary of custom variables to be stored in the bot context and used later in the scenario. Can include any data such as sentiment analysis, extracted entities, or other metadata.

Headers
string
required

The JWT token string received in the jwt.token field from the webhook payload. This JWT is valid for 60 seconds and can only be used once. You cannot reuse a JWT received for user A to send an AI generated answer to another user B.

Responses

Updated 3 months ago

Language
Credentials
:
LoadingLoading…
Response
Choose an example:
application/json

Updated 3 months ago