Chatva

Search documentation

Search titles, instructions and image captions. Use ↑ ↓ to choose a result, Enter to open, Esc to close.

Enter a channel name or describe the step you need.

    Documentation: Avito

    Avito

    Updated October 11, 2026

    On this page

    Prepare the account in Avito first: check the subscription that enables messaging API access, then obtain two credentials. This guide shows where to open the plan settings, what to check, and where to copy Client_id and Client_secret.

    What you need

    • Access to the Avito account that owns the listings. For a company, use its main account: an employee’s credentials may not grant access to company listing conversations.
    • An active subscription at an eligible level, listed below. For other categories or custom plans, confirm access with Avito first.
    • A browser to open the Avito account settings, plus owner or administrator access to your Chatva workspace.

    1. Check the Avito subscription — required

    The official Messenger API documentation lists different requirements by category. Having API credentials does not remove the subscription requirement.

    Avito categorySubscription with Messenger APIWhat to check
    Goods«Максимальный»Avito does not list «Расширенный» as an eligible level for this category.
    Jobs«Максимальный»The subscription must apply to the account you are connecting.
    Services«Расширенный» / «Максимальный»Either of these two levels is eligible while the subscription is active.
    Other categories and custom arrangementsConfirm with Avito before payingDo not automatically apply the Goods or Services requirements to another category.
    1. Open the plan for the correct account

      Sign in to Avito and open plan configuration. In the Avito Pro sidebar, this section is labelled «Тариф». If this is your first plan, the Avito plan overview leads to options for your category.

    2. Match the category and subscription level

      In plan settings, check the category covered by your services and compare the level with the table above. Check Messenger API specifically: listing or statistics API access does not establish messaging access.

    3. Confirm the included features before paying

      If the names or included features differ, ask Avito support to confirm access for your profile. Check the price, subscription period, and renewal terms in Avito before confirming payment. After purchase, verify that the required subscription is active.

    Open «Тариф» in Avito Pro. This is a crop of a published Avito account screenshot; the highlight was added for this guide.

    Source: Avito screenshot · 5SYSTEMS guide ↗

    Open «Тариф» in Avito Pro. This is a crop of a published Avito account screenshot; the highlight was added for this guide.

    Source: Avito screenshot · 5SYSTEMS guide ↗
    The «Тариф» item highlighted in the Avito Pro sidebar

    What to ask Avito support

    Open the Avito help centre while signed into the intended account. Include your listing category and current subscription name. You can copy this request:

    Request to Avito support

    Hello! I want to connect my Avito account messages to Chatva through Messenger API.
    Listing category: [your category].
    Current subscription: [subscription name].
    Please confirm access to reading and sending messages and receiving new-message notifications through Messenger API. If it is unavailable, which subscription is required for this account and category?

    Do not include Client_secret, your password, or sign-in codes in the request. Avito can confirm the subscription and API access conditions.

    2. Find and obtain the credentials in Avito

    Open Integrations and API

    1. Open your profile’s credentials

      Open avito.ru/professionals/api and sign into the intended account if requested. In the illustrated account interface, choose «Профиль и настройки» → «Интеграции и API». Other versions may show «Для профессионалов» → «API»; the direct link opens the credentials section.

    The route to API settings in Avito. Personal details are outside this crop. Menu labels may differ in a newer Avito interface.

    Source: Avito screenshot · 5SYSTEMS guide ↗

    The route to API settings in Avito. Personal details are outside this crop. Menu labels may differ in a newer Avito interface.

    Source: Avito screenshot · 5SYSTEMS guide ↗
    Avito menu: Profile and settings, then Integrations and API

    Select Get credentials

    1. Find the Custom development section

      On the API page, scroll to «Собственная разработка» and select «Получить ключи» if credentials have not been issued. If values are already visible, use them; connecting Chatva does not require reissuing credentials. If the section or button is missing, contact Avito support.

    The credentials button in a published Avito interface screenshot. This shows the button’s location; the Messenger API subscription requirements are listed in the table above.

    Source: Avito screenshot · 5SYSTEMS guide ↗

    The credentials button in a published Avito interface screenshot. This shows the button’s location; the Messenger API subscription requirements are listed in the table above.

    Source: Avito screenshot · 5SYSTEMS guide ↗
    Avito Integrations and API shows Custom development and the Get credentials button

    Copy both values

    1. Client_id → Client ID; Client_secret → Client secret

      Copy both complete values from the same Avito page. Paste Client_id into Chatva’s Client ID field and Client_secret into Client secret. Exclude the field labels and extra whitespace. Your Avito password is not one of these credentials.

    Both fields are required. The original screenshot’s values are concealed and cannot be used to connect.

    Source: Avito screenshot · 5SYSTEMS guide ↗

    Both fields are required. The original screenshot’s values are concealed and cannot be used to connect.

    Source: Avito screenshot · 5SYSTEMS guide ↗
    Avito Client_id and Client_secret fields with values concealed

    3. Complete the Chatva connection

    In the intended Chatva workspace, open Channels → Avito → Connect, enter Client ID and Client secret, and select Connect. Chatva checks the credentials, identifies the account, and subscribes to message notifications. You do not need to enter a webhook URL manually in Avito.

    4. Test messages in both directions

    1. Send a message about your listing from another account

      Open one of your listings on Avito from a different account, or ask a colleague to send “Connection test”. It must be a new message to the connected profile.

    2. Find the conversation in Chatva

      Open the correct workspace’s inbox and temporarily clear assignee and status filters. Check the Avito channel, sender, and listing details when supplied by Avito.

    3. Reply and check delivery in Avito

      Reply from Chatva and check the other account’s Avito messages. The test succeeds when the new inquiry reaches the inbox and your reply appears in Avito.

    How conversations and the subscription work after connection

    • Use a new message to test the connection. A complete historical archive is not a requirement for a successful connection.
    • Chatva replies within an existing Avito conversation. For the first test, another account starts the conversation through your listing.
    • Keep track of your Avito subscription and included services. If Messenger API access is disabled, confirm that Avito has restored it, then repeat the incoming-message and reply test.

    Troubleshooting

    What happenedWhere to go and what to check
    Avito services are paid, but messages are unavailableOpen Avito plan settings. Paying for listings or promotion does not establish Messenger API subscription access. Match the category and level to the table above.
    API section or credentials button is missingOpen the direct credentials link and check the selected profile. If credentials already exist, copy them. If the section is unavailable, ask Avito why.
    Credential or authorization errorCopy the pair again from Avito settings. Check Client_id, Client_secret, the account, and extra spaces. OAuth application credentials and the account password do not replace personal credentials.
    Access error, 403, or API subscription requiredFirst check the subscription and company’s main account. If the eligible level is active, ask Avito support to check Messenger API access for this profile. A 403 alone does not prove that payment is the only cause.
    Some company listings or conversations are missingCheck whose credentials were used. Messenger API restricts company conversations when authorized as an employee; use the main company account’s credentials.
    Subscription is active, but no messages arriveConfirm with Avito that access is active for the intended profile. Reconnect in Chatva and send a new test message. If it still fails, give Chatva support the test time and error text with credentials concealed.