Skip to main content
ZapThinker API allows the creation and management of bots using EvoAI technology, providing advanced automation and interactivity through different types of bots. EvoAI is a technology developed by the Evolution team. You can learn more at evo-ai.co. Below, you will find detailed instructions on how to configure bots, manage sessions, and set default configurations.

​
1. Creating Bots in EvoAI

You can configure various bots in EvoAI using triggers to initiate interactions. Bot configuration can be done through the /evoai/create/{{instance}} endpoint.

​
Endpoint for Bot Creation

​
Endpoint

POST {{baseUrl}}/evoai/create/{{instance}}

​
Request Body

Here is an example of a JSON body to configure a bot in EvoAI: 
{
    "enabled": true,
    "agentUrl": "http://evoai.site.com/v1",
    "apiKey": "app-123456",
    // options
    "triggerType": "keyword", /* all or keyword */
    "triggerOperator": "equals", /* contains, equals, startsWith, endsWith, regex, none */
    "triggerValue": "test",
    "expire": 0,
    "keywordFinish": "#EXIT",
    "delayMessage": 1000,
    "unknownMessage": "Message not recognized",
    "listeningFromMe": false,
    "stopBotFromMe": false,
    "keepOpen": false,
    "debounceTime": 0,
    "ignoreJids": []
}

​
Parameters Explanation

  • enabled: Enables (true) or disables (false) the bot.
  • agentUrl: EvoAI API URL (without a trailing /).
  • apiKey: API key provided by EvoAI.
  • Options:
    • triggerType: Type of trigger to start the bot (all or keyword).
    • triggerOperator: Operator used to evaluate the trigger (contains, equals, startsWith, endsWith, regex, none).
    • triggerValue: Value used in the trigger (e.g., a keyword or regex).
    • expire: Time in minutes after which the bot expires, restarting if the session has expired.
    • keywordFinish: Keyword that ends the bot session.
    • delayMessage: Delay (in milliseconds) to simulate typing before sending a message.
    • unknownMessage: Message sent when the user’s input is not recognized.
    • listeningFromMe: Defines if the bot should listen to messages sent by the user (true or false).
    • stopBotFromMe: Defines if the bot should stop when the user sends a message (true or false).
    • keepOpen: Keeps the session open, preventing the bot from restarting for the same contact.
    • debounceTime: Time (in seconds) to combine multiple messages into one.
    • ignoreJids: List of JIDs of contacts that will not activate the bot.

​
2. EvoAI Default Settings

You can define default settings that will be applied if parameters are not passed during bot creation.

​
Endpoint for Default Settings

​
Endpoint

POST {{baseUrl}}/evoai/settings/{{instance}}

​
Request Body

Here is an example of default settings: 
{
    "expire": 20,
    "keywordFinish": "#EXIT",
    "delayMessage": 1000,
    "unknownMessage": "Message not recognized",
    "listeningFromMe": false,
    "stopBotFromMe": false,
    "keepOpen": false,
    "debounceTime": 0,
    "ignoreJids": [],
    "evoaiIdFallback": "clyja4oys0a3uqpy7k3bd7swe"
}

​
Parameters Explanation

  • expire: Time in minutes after which the bot expires.
  • keywordFinish: Keyword that ends the bot session.
  • delayMessage: Delay to simulate typing before sending a message.
  • unknownMessage: Message sent when the user’s input is not recognized.
  • listeningFromMe: Defines if the bot should listen to messages sent by the user.
  • stopBotFromMe: Defines if the bot should stop when the user sends a message.
  • keepOpen: Keeps the session open, preventing the bot from restarting for the same contact.
  • debounceTime: Time to combine multiple messages into one.
  • ignoreJids: List of JIDs of contacts that will not activate the bot.
  • evoaiIdFallback: Fallback bot ID that will be used if no trigger is activated.

​
3. Managing EvoAI Sessions

You can manage the bot sessions by changing the status between open, paused, or closed for each specific contact.

​
Endpoint for Session Management

​
Endpoint

POST {{baseUrl}}/evoai/changeStatus/{{instance}}

​
Request Body

Here is an example of how to manage the session status: 
{
    "remoteJid": "[email protected]",
    "status": "closed"
}

​
Parameters Explanation

  • remoteJid: JID (identifier) of the contact on WhatsApp.
  • status: Session status (opened, paused, closed).

​
4. Automatic Variables in EvoAI

When an EvoAI session is started, some predefined variables are automatically sent: 
inputs: {
    remoteJid: "Contact JID",
    pushName: "Contact name",
    instanceName: "Instance name",
    serverUrl: "API server URL",
    apiKey: "ZapThinker API Key"
};

​
Automatic Variables Explanation

  • remoteJid: JID of the contact the bot is interacting with.
  • pushName: Contact’s name on WhatsApp.
  • instanceName: Name of the instance running the bot.
  • serverUrl: URL of the server where ZapThinker API is hosted.
  • apiKey: API key used to authenticate requests.

​
Final Considerations

The integration of ZapThinker API with EvoAI offers a robust way to automate interactions on WhatsApp. With the ability to configure triggers, manage sessions, and use automatic variables, you can optimize the workflow and improve the end-user experience.