{"id":35745,"date":"2026-01-11T01:35:26","date_gmt":"2026-01-10T18:35:26","guid":{"rendered":"https:\/\/dps.media\/huong-dan-tich-hop-viber-vao-chatwoot-toan-tap-giai-phap-cho-nguoi-moi\/"},"modified":"2026-01-11T01:35:26","modified_gmt":"2026-01-10T18:35:26","slug":"guide-integrate-viber-into-chatwoot-complete-solution-for-beginners","status":"publish","type":"post","link":"https:\/\/dps.media\/en\/guide-integrate-viber-into-chatwoot-complete-solution-for-beginners\/","title":{"rendered":"Viber Integration Guide into Chatwoot (Complete): Solution for Beginners"},"content":{"rendered":"

\"Integrate<\/p>

You are using Chatwoot to manage multi-channel customer care but missing an important channel in Vietnam: Viber<\/strong>?<\/p>

M\u1eb7c d\u00f9 Chatwoot hi\u1ec7n h\u1ed7 tr\u1ee3 native (t\u00edch h\u1ee3p s\u1eb5n) cho Facebook, Telegram, Zalo (qua Official Account), nh\u01b0ng Viber v\u1eabn ch\u01b0a c\u00f3 m\u1eb7t trong danh s\u00e1ch \u201cout-of-the-box\u201d. Tuy nhi\u00ean, \u0111\u1eebng lo l\u1eafng! V\u1edbi ki\u1ebfn tr\u00fac m\u1edf c\u1ee7a Chatwoot th\u00f4ng qua API Channel<\/strong>, it's completely possible to bring messages from Viber to Chatwoot for centralized management.<\/p>

This article will guide you in detail on how to do that.<\/p>

Why isn't there native integration yet?<\/h2>

Chatwoot is an open-source platform, and community integrations are being developed. While waiting for the official update, we will use the method \u201cC\u1ea7u n\u1ed1i\u201d (Bridge)<\/strong>.<\/p>

Operating principle:<\/strong>
\nWe will need a middleware station to stand in between:<\/p>

    \n
  1. Viber Webhook<\/strong> nh\u1eadn tin nh\u1eafn t\u1eeb ng\u01b0\u1eddi d\u00f9ng -> G\u1eedi \u0111\u1ebfn Middleware.<\/li>\n
  2. Middleware<\/strong> chuy\u1ec3n \u0111\u1ed5i \u0111\u1ecbnh d\u1ea1ng -> G\u1ecdi API Chatwoot \u0111\u1ec3 t\u1ea1o tin nh\u1eafn.<\/li>\n
  3. Chatwoot Webhook<\/strong> (khi nh\u00e2n vi\u00ean tr\u1ea3 l\u1eddi) -> G\u1eedi \u0111\u1ebfn Middleware.<\/li>\n
  4. Middleware<\/strong> g\u1ecdi API Viber -> G\u1eedi tin nh\u1eafn \u0111\u1ebfn ng\u01b0\u1eddi d\u00f9ng.<\/li>\n<\/ol>

    \"Operation<\/p>

    For simplicity and no coding required (No-code\/Low-code), this guide will suggest using n8n<\/strong> \u2013 m\u1ed9t c\u00f4ng c\u1ee5 t\u1ef1 \u0111\u1ed9ng h\u00f3a m\u1ea1nh m\u1ebd m\u00e0 ch\u00fang t\u00f4i th\u01b0\u1eddng xuy\u00ean gi\u1edbi thi\u1ec7u.<\/p>

    Preparation<\/h2>

    Before starting, you need:<\/p>

      \n
    1. Viber Admin Panel account<\/strong>: To create Bot and get Token.<\/li>\n
    2. Chatwoot<\/strong>: Installed and running (Cloud or Self-hosted version).<\/li>\n
    3. n8n (or middleware server)<\/strong>: To run the connection workflow.<\/li>\n<\/ol>

      B\u01b0\u1edbc 1: T\u1ea1o Viber Bot & L\u1ea5y Token<\/h2>

      \u0110\u1ea7u ti\u00ean, b\u1ea1n c\u1ea7n t\u1ea1o m\u1ed9t \u201ccon bot\u201d tr\u00ean Viber. \u0110\u00e2y s\u1ebd l\u00e0 b\u1ed9 m\u1eb7t doanh nghi\u1ec7p c\u1ee7a b\u1ea1n tr\u00ean Viber.<\/p>

        \n
      1. Access Viber Admin Panel<\/a><\/strong>.<\/li>\n
      2. Log in with your Viber phone number.<\/li>\n
      3. Press Create Bot Account<\/strong>.<\/li>\n
      4. \u0110i\u1ec1n \u0111\u1ea7y \u0111\u1ee7 th\u00f4ng tin: T\u00ean Bot, H\u00ecnh \u0111\u1ea1i di\u1ec7n, M\u00f4 t\u1ea3, Website\u2026<\/li>\n
      5. After creating, you will receive a Token<\/strong> (as shown below). Please save this code carefully<\/strong>, this is the key for Chatwoot to knock on Viber's door.<\/li>\n<\/ol>

        \"Get<\/p>

        Step 2: Set up API Channel on Chatwoot<\/h2>

        Tr\u00ean Chatwoot, ch\u00fang ta kh\u00f4ng ch\u1ecdn k\u00eanh \u201cFacebook\u201d hay \u201cTelegram\u201d, m\u00e0 s\u1ebd ch\u1ecdn k\u00eanh \u0111\u1eb7c bi\u1ec7t l\u00e0 API<\/strong>.<\/p>

          \n
        1. Go to Settings<\/strong> > Inboxes<\/strong>.<\/li>\n
        2. Select Add Inbox<\/strong>.<\/li>\n
        3. Select channel type as API<\/strong>.<\/li>\n
        4. \u0110\u1eb7t t\u00ean: V\u00ed d\u1ee5 \u201cViber Support\u201d.<\/li>\n
        5. Webhook URL: Leave blank temporarily or fill in n8n URL (will update in next step)<\/em>.<\/li>\n
        6. Complete and add Agents to this inbox.<\/li>\n<\/ol>

          After creating, you will have Inbox ID<\/code> and API Access Token<\/code> of Chatwoot (in that inbox settings).<\/p>

          \"Create<\/p>

          B\u01b0\u1edbc 3: X\u00e2y d\u1ef1ng \u201cC\u1ea7u n\u1ed1i\u201d (Bridge)<\/h2>

          This is the most important step. If you know programming (NodeJS, Python), you can write a small server. If not, use n8n<\/strong>.<\/p>

          Lu\u1ed3ng 1: T\u1eeb Viber -> Chatwoot (Kh\u00e1ch nh\u1eafn tin)<\/h3>

          You need to create an n8n workflow that listens to Webhook from Viber.
          \nNote: Viber requires Webhook to be valid HTTPS.<\/em><\/p>

          Processing flow:<\/p>

            \n
          1. Webhook Node<\/strong>: Receive POST data from Viber.<\/li>\n
          2. IF Node<\/strong>: Check event<\/code> is it message<\/code> no.<\/li>\n
          3. HTTP Request (Chatwoot)<\/strong>:\n
              \n
            • Call to: POST \/api\/v1\/accounts\/{account_id}\/conversations<\/code> (to create or find conversation).<\/li>\n
            • Body: Send with source_id<\/code> is Viber user ID (to identify customer).<\/li>\n
            • Then call: POST \/api\/v1\/accounts\/{account_id}\/conversations\/{conversation_id}\/messages<\/code>.<\/li>\n
            • Content: Get text<\/code> from Viber message sent.<\/li>\n<\/ul>\n<\/li>\n<\/ol>

              Lu\u1ed3ng 2: T\u1eeb Chatwoot -> Viber (Nh\u00e2n vi\u00ean tr\u1ea3 l\u1eddi)<\/h3>

              You need to configure Webhook in Chatwoot (in the settings of the newly created Inbox API) to send data to n8n every time there is a new message.<\/p>

              Processing flow:<\/p>

                \n
              1. Webhook Node<\/strong>: Receive data from Chatwoot.<\/li>\n
              2. IF Node<\/strong>: Check message_type<\/code> is it outgoing<\/code> (outgoing) and private<\/code> is false<\/code> no (to avoid sending internal notes to customer).<\/li>\n
              3. HTTP Request (Viber)<\/strong>:\n
                  \n
                • Call to: https:\/\/chatapi.viber.com\/pa\/send_message<\/code><\/li>\n
                • Header: X-Viber-Auth-Token: <\/code><\/li>\n
                • Body:\n
                  {\n   \"receiver\": \"\",\n   \"type\": \"text\",\n   \"text\": \"\"\n}\n<\/code><\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>
                  Step 4: Test and Operate<\/h2>
                  After setting up the above 2 flows:<\/p>
                    \n
                  1. Use your personal phone to message your Viber Bot.<\/li>\n
                  2. Ki\u1ec3m tra tr\u00ean Chatwoot xem tin nh\u1eafn c\u00f3 hi\u1ec7n l\u00ean kh\u00f4ng? -> N\u1ebfu c\u00f3: Flow 1 successful<\/strong>.<\/li>\n
                  3. From Chatwoot, type reply to customer.<\/li>\n
                  4. Ki\u1ec3m tra \u0111i\u1ec7n tho\u1ea1i xem Bot Viber c\u00f3 ph\u1ea3n h\u1ed3i kh\u00f4ng? -> N\u1ebfu c\u00f3: Stream 2 successful<\/strong>.<\/li>\n<\/ol>
                    \"Demo<\/p>
                    Conclusion<\/h2>
                    Vi\u1ec7c t\u00edch h\u1ee3p Viber v\u00e0o Chatwoot tuy c\u1ea7n m\u1ed9t ch\u00fat thao t\u00e1c k\u1ef9 thu\u1eadt (\u201cc\u1ea7u n\u1ed1i\u201d) nh\u01b0ng s\u1ebd mang l\u1ea1i hi\u1ec7u qu\u1ea3 to l\u1edbn trong vi\u1ec7c t\u1eadp trung h\u00f3a CSKH. B\u1ea1n kh\u00f4ng c\u1ea7n ph\u1ea3i m\u1edf \u1ee9ng d\u1ee5ng Viber ri\u00eang l\u1ebb n\u1eefa, m\u1ecdi th\u1ee9 \u0111\u1ec1u n\u1eb1m trong dashboard chuy\u00ean nghi\u1ec7p c\u1ee7a Chatwoot.<\/p>
                    If you have difficulty configuring n8n, don't hesitate to leave a comment or contact our technical team<\/strong> for detailed setup support!<\/p>\n