search_emails
Searches every connected mailbox (sender, subject, preview), newest first. Operators: from:, subject:, before:YYYY-MM-DD, after:YYYY-MM-DD, in:sent (only what the user sent, from any mailbox or alias); the rest is free text. Deleted emails are not returned.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
}
get_email
One email in full: sender, recipients, date, subject, plain-text body, attachment names, folder and BumbleBox classification.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
list_to_answer
Received emails BumbleBox classified as needing a reply and still in the inbox, newest first.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}
search_contacts
Contacts BumbleBox knows from the mail history (name, address, organization domain, exchange counts, last exchanges, VIP mark, note), matched on name, address or domain.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200
}
},
"additionalProperties": false
}
list_folders
The folders of each connected mailbox, as last synced. Trash, spam, sent and drafts are left out.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": []
}
list_calendar_events
Events of the connected Google calendars between two dates (default: the next 7 days, at most 62 days).
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"format": "date-time"
},
"from": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
}
draft_reply
Saves the text as the reply draft of a received email, from the address the email was written to (a brand address or the mailbox). needsIdentity: that address cannot send until the user verifies it in BumbleBox. Nothing is sent: the draft waits in BumbleBox (Pilotage › prepared replies) until the user reviews it and clicks Send. Saving again replaces the previous draft of the same email.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email_id",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "Plain-text reply body."
},
"subject": {
"type": "string",
"maxLength": 300,
"description": "Defaults to \"Re: <original subject>\"."
},
"email_id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
send_reply
Replies to the sender of one received email, and only to them (no Cc, no Bcc, no attachment), from the address the email was written to. What happens next is the level the user set in BumbleBox for this kind of reply: a draft, a reply waiting for one tap (the default), or a reply that leaves after a delay the user can cancel. Anything that commits the user (amounts, bank details, acceptance, contracts, dates, links) always waits for the user, and so does a reply from an address the user has not verified (needsIdentity). The result says which one applied.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email_id",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "Plain-text reply body."
},
"email_id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
archive_email
Moves one inbox email to its mailbox's archive folder, on the mail server too. Undone by restore to inbox. Nothing is deleted.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
move_email
Moves one inbox email to an existing folder of the same mailbox (see list folders), on the mail server too. No folder is created. Undone by restore to inbox.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email_id",
"folder"
],
"properties": {
"folder": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"email_id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
trash_email
Moves one email to its mailbox's trash. In the inbox: only when BumbleBox certifies it as noise (spam, newsletter, promotion, unanimous safety vote, no known contact or action word). Already filed out of the inbox (Notifications, Newsletters, archive…): when it is noise, a notification or an automated alert, with no known contact or action word. Any other email is not moved: it becomes a proposal the user confirms in one tap in BumbleBox. Never a permanent deletion; undone by restore to inbox.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email_id"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 300,
"description": "Why, shown to the user with a proposal."
},
"email_id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
clean_filed_mail
Moves to the trash every email of one sender (an address, or @domain for a whole domain) that is already filed out of the inbox, in every connected mailbox, when it is noise, a notification or an automated alert. Because the sender is named, action words and known-contact status do not keep a mail; a protected category (a real conversation, a transaction, a legal notice) or a mail the user reclassified by hand still stays. The inbox is never touched, nor a mail the server still shows in the inbox. Returns how many were trashed, which were kept and why, how many are still in the inbox and how m
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sender"
],
"properties": {
"folder": {
"type": "string",
"maxLength": 300,
"description": "Only the mail filed in this folder (see list_folders)."
},
"sender": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "An email address, or @domain.com for every address of that domain."
}
},
"additionalProperties": false
}
restore_to_inbox
Moves an archived, filed or trashed email back to the inbox, on the mail server too.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Email id, as returned by search_emails or list_to_answer."
}
},
"additionalProperties": false
}
list_missions
The user's prospection campaigns (missions), most recently active first, with the number of drafts waiting, emails sent and prospects who replied.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
}
},
"additionalProperties": false
}
list_campaign_drafts
The drafts of one campaign that wait for the user to validate them in BumbleBox (recipient, subject, plain-text body, sender), newest first, with the true totals.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mission_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"mission_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Campaign id, as returned by list_missions."
}
},
"additionalProperties": false
}
list_replies_to_validate
Replies received on campaigns that still need the user: prepared reply drafts waiting for validation, and replies with no answer yet (with the stored AI triage: kind, summary, whether a human is needed).
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": []
}
create_campaign_draft
Writes one draft inside an existing campaign, to one recipient (added to the campaign list if new), from the campaign's sender. Nothing is sent: the draft waits for the user to validate the campaign send in BumbleBox.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mission_id",
"to",
"subject",
"body"
],
"properties": {
"to": {
"type": "string",
"maxLength": 320,
"minLength": 3
},
"body": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "Plain-text body."
},
"name": {
"type": "string",
"maxLength": 200,
"description": "Recipient name, for a new prospect."
},
"subject": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"mission_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Campaign id, as returned by list_missions."
}
},
"additionalProperties": false
}
update_campaign_draft
Changes the subject, body or recipient of a draft that is still a draft. Nothing is sent, and a draft the user already validated cannot be changed.
Показать схему аргументов
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mission_id",
"draft_id"
],
"properties": {
"to": {
"type": "string",
"maxLength": 320,
"minLength": 3
},
"body": {
"type": "string",
"maxLength": 20000,
"minLength": 1
},
"subject": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"draft_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"mission_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Campaign id, as returned by list_missions."
}
},
"additionalProperties": false
}