Automation

Upload Bot Avatar

Upload an avatar image for an automation bot.

Replaces any existing bot avatar. The uploaded image is stored in GCP Cloud Storage and a signed URL is saved to the bot's avatar_url field.

Required Scopes: automation:update

Constraints:

  • File type: PNG, JPG, JPEG
  • Max size: 2MB
post/api/v1/automation/bots/{bot_id}/avatar

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/automation/bots/{bot_id}/avatar
  • Auth: HTTP bearer

Path parameters

bot_idstring required

Response

Successful Response

idstring required
tenant_idstring required
namestring required
bot_type'assistant' | 'support' | 'router' | 'sales' | 'lead_qualification' | 'faq' | 'appointment' | 'keyword' | 'email_support' | 'agent' required

Type of automation bot.

'assistant' is the preferred value for new bots (Phase 2 consolidation). All legacy values remain valid for backwards compatibility.

is_activeboolean required
priorityinteger
personality_promptstring nullable
greeting_messagestring nullable
escalation_keywordsstring[] nullable
display_namestring nullable
avatar_urlstring nullable
ai_disclosure_messagestring nullable
ai_disclosure_include_escalationboolean
is_kb_only_modeboolean required
response_languagestring nullable
confidence_thresholdnumber required
is_detailed_responseboolean
use_full_conversation_contextboolean
vision_enabledboolean
web_search_modestring nullable
web_search_allowed_domainsstring[] nullable
web_search_required_keywordsstring[] nullable
web_search_max_per_conversationinteger nullable
deep_answers_enabledboolean
auto_translate_messagesboolean
language_detection_strategystring nullable
escalation_enabledboolean
offers_escalationboolean required
max_failed_attemptsinteger required
handoff_messagestring nullable
no_answer_messagestring nullable
escalation_offer_messagestring nullable
immediate_handoff_thresholdnumber nullable
required_fieldsobject[] nullable
routing_configobject nullable
is_field_collection_modeboolean
calendly_event_type_uristring nullable
offline_escalation_behavior'leave_message' | 'escalate_anyway' | 'continue_bot'

What to do when escalation triggers but no agents are online (live chat)

offline_messagestring nullable
outside_hours_messagestring nullable
is_escalation_schedule_enabledboolean
escalation_timezonestring
escalation_scheduleobject[] nullable
escalation_tag_idstring nullable
escalation_routing_strategystring nullable
escalation_fallback_minutesinteger nullable
max_email_repliesinteger
is_email_reply_modeboolean
coexist_bot_idstring nullable
coexist_modestring nullable
base_languagestring nullable
translation_cacheobject nullable
greeting_buttons_enabledboolean
greeting_human_button_captionstring nullable
greeting_continue_button_captionstring nullable
greeting_continue_ack_messagestring nullable
source_footer_enabledboolean
source_footer_modestring nullable
source_link_paramsobject nullable
kb_live_refresh_modestring nullable
kb_live_refresh_ttl_secondsinteger nullable
total_conversationsinteger
total_escalationsinteger
created_atstring date-time required
updated_atstring date-time nullable
activation_rules_countinteger
keyword_triggers_countinteger nullable

Changes

No recorded changes to this operation across all 3 revisions of this API.