Update Inbox

curl --request PATCH \
  --url https://app.yampi.ai/api/v1/accounts/{account_id}/inboxes/{id} \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "name": "Support",
  "greeting_enabled": true,
  "greeting_message": "Hello, how can I help you?",
  "enable_email_collect": true,
  "enable_auto_assignment": true,
  "working_hours_enabled": true,
  "timezone": "America/New_York",
  "allow_messages_after_resolved": true,
  "channel": {
    "website_url": "https://example.com",
    "welcome_title": "Welcome to our support",
    "welcome_tagline": "We are here to help you",
    "widget_color": "#FF5733",
    "reply_time": "in_a_few_minutes",
    "pre_chat_form_enabled": false,
    "continuity_via_email": true,
    "hmac_mandatory": false,
    "selected_feature_flags": [
      "attachments",
      "emoji_picker",
      "end_conversation"
    ]
  }
}
'

{
  "id": 123,
  "name": "<string>",
  "website_url": "<string>",
  "channel_type": "<string>",
  "avatar_url": "<string>",
  "widget_color": "<string>",
  "website_token": "<string>",
  "enable_auto_assignment": true,
  "web_widget_script": "<string>",
  "welcome_title": "<string>",
  "welcome_tagline": "<string>",
  "greeting_enabled": true,
  "greeting_message": "<string>",
  "channel_id": 123,
  "working_hours_enabled": true,
  "enable_email_collect": true,
  "csat_survey_enabled": true,
  "auto_assignment_config": {},
  "out_of_office_message": "<string>",
  "working_hours": [
    {
      "day_of_week": 123,
      "closed_all_day": true,
      "open_hour": 123,
      "open_minutes": 123,
      "close_hour": 123,
      "close_minutes": 123,
      "open_all_day": true
    }
  ],
  "timezone": "<string>",
  "callback_webhook_url": "<string>",
  "allow_messages_after_resolved": true,
  "lock_to_single_conversation": true,
  "sender_name_type": "<string>",
  "business_name": "<string>",
  "hmac_mandatory": true,
  "selected_feature_flags": {},
  "reply_time": "<string>",
  "messaging_service_sid": "<string>",
  "phone_number": "<string>",
  "medium": "<string>",
  "provider": "<string>"
}

{
  "description": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>",
      "code": "<string>"
    }
  ]
}

{
  "description": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>",
      "code": "<string>"
    }
  ]
}

PATCH

api

accounts

{account_id}

inboxes

{id}

curl --request PATCH \
  --url https://app.yampi.ai/api/v1/accounts/{account_id}/inboxes/{id} \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "name": "Support",
  "greeting_enabled": true,
  "greeting_message": "Hello, how can I help you?",
  "enable_email_collect": true,
  "enable_auto_assignment": true,
  "working_hours_enabled": true,
  "timezone": "America/New_York",
  "allow_messages_after_resolved": true,
  "channel": {
    "website_url": "https://example.com",
    "welcome_title": "Welcome to our support",
    "welcome_tagline": "We are here to help you",
    "widget_color": "#FF5733",
    "reply_time": "in_a_few_minutes",
    "pre_chat_form_enabled": false,
    "continuity_via_email": true,
    "hmac_mandatory": false,
    "selected_feature_flags": [
      "attachments",
      "emoji_picker",
      "end_conversation"
    ]
  }
}
'

{
  "id": 123,
  "name": "<string>",
  "website_url": "<string>",
  "channel_type": "<string>",
  "avatar_url": "<string>",
  "widget_color": "<string>",
  "website_token": "<string>",
  "enable_auto_assignment": true,
  "web_widget_script": "<string>",
  "welcome_title": "<string>",
  "welcome_tagline": "<string>",
  "greeting_enabled": true,
  "greeting_message": "<string>",
  "channel_id": 123,
  "working_hours_enabled": true,
  "enable_email_collect": true,
  "csat_survey_enabled": true,
  "auto_assignment_config": {},
  "out_of_office_message": "<string>",
  "working_hours": [
    {
      "day_of_week": 123,
      "closed_all_day": true,
      "open_hour": 123,
      "open_minutes": 123,
      "close_hour": 123,
      "close_minutes": 123,
      "open_all_day": true
    }
  ],
  "timezone": "<string>",
  "callback_webhook_url": "<string>",
  "allow_messages_after_resolved": true,
  "lock_to_single_conversation": true,
  "sender_name_type": "<string>",
  "business_name": "<string>",
  "hmac_mandatory": true,
  "selected_feature_flags": {},
  "reply_time": "<string>",
  "messaging_service_sid": "<string>",
  "phone_number": "<string>",
  "medium": "<string>",
  "provider": "<string>"
}

{
  "description": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>",
      "code": "<string>"
    }
  ]
}

{
  "description": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>",
      "code": "<string>"
    }
  ]
}

Authorizations

api_access_token

string

header

required

Token de usuario. Envía el valor en el header api_access_token. Lo obtienes en el perfil (GET /api/v1/profile) o al regenerarlo.

Path Parameters

account_id

integer

required

The numeric ID of the account

number

required

ID of the inbox

Body

application/json

name

string

The name of the inbox.

Example:

"Support"

avatar

file

Image file for avatar.

greeting_enabled

boolean

Enable greeting message.

Example:

true

greeting_message

string

Greeting message to send when greeting messages are enabled.

Example:

"Hello, how can I help you?"

enable_email_collect

boolean

Enable email collection.

Available for: Website

Example:

true

csat_survey_enabled

boolean

Enable CSAT survey.

Example:

true

csat_config

object

CSAT survey configuration.

Show child attributes

enable_auto_assignment

boolean

Enable Auto Assignment.

Example:

true

working_hours_enabled

boolean

Enable working hours.

Example:

true

out_of_office_message

string

Out of office message to send outside working hours.

Example:

"We are currently out of office. Please leave a message and we will get back to you."

timezone

string

Timezone of the inbox.

Example:

"America/New_York"

allow_messages_after_resolved

boolean

Allow messages after conversation is resolved.

Available for: Website

Example:

true

lock_to_single_conversation

boolean

Lock contact messages to a single active conversation.

Available for: API LINE Telegram WhatsApp SMS

Example:

true

portal_id

integer

Id of the help center portal to attach to the inbox.

Example:

1

sender_name_type

enum<string>

Sender name type for outbound email replies.

Available for: Website Email

Available options:

friendly,

professional

Example:

"friendly"

business_name

string

Business name for outbound email replies.

Available for: Website Email

Example:

"My Business"

channel

Website channel settings · object

Show child attributes

Response

Success

number

ID of the inbox

name

string

The name of the inbox

website_url

string

Website URL

channel_type

string

The type of the inbox

avatar_url

string

The avatar image of the inbox

Widget Color used for customization of the widget

website_token

string

Website Token

enable_auto_assignment

boolean

The flag which shows whether Auto Assignment is enabled or not

Script used to load the website widget

welcome_title

string

Welcome title to be displayed on the widget

welcome_tagline

string

Welcome tagline to be displayed on the widget

greeting_enabled

boolean

The flag which shows whether greeting is enabled

greeting_message

string

A greeting message when the user starts the conversation

channel_id

number

ID of the channel this inbox belongs to

working_hours_enabled

boolean

The flag which shows whether working hours feature is enabled

enable_email_collect

boolean

The flag to enable collecting email from contacts

csat_survey_enabled

boolean

The flag to enable CSAT survey

auto_assignment_config

object

Configuration settings for auto assignment

out_of_office_message

string

Message to show when agents are out of office

working_hours

object[]

Configuration for working hours of the inbox

Show child attributes

timezone

string

Timezone configuration for the inbox

callback_webhook_url

string

Webhook URL for callbacks

allow_messages_after_resolved

boolean

Whether to allow messages after a conversation is resolved

lock_to_single_conversation

boolean

Whether to lock a contact to a single conversation

sender_name_type

string

Type of sender name to display (e.g., friendly)

business_name

string

Business name associated with the inbox

hmac_mandatory

boolean

Whether HMAC verification is mandatory

selected_feature_flags

object

Selected feature flags for the inbox

reply_time

string

Expected reply time

messaging_service_sid

string

Messaging service SID for SMS providers

phone_number

string

Phone number associated with the inbox

medium

string

Medium of communication (e.g., sms, email)

provider

string

Provider of the channel