> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doko-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> How to integrate your chatbot with WhatsApp for a smooth user experience.

## Video Tutorial

<Card title="Watch the tutorial" icon="youtube" href="https://www.youtube.com/watch?v=5PfdBczfexM">
  Watch the tutorial to integrate your chatbot with WhatsApp.
</Card>

[Create your chatbot here](https://doko-ai.com/es/sign-up)

### Prerequisites

1. Create a Meta Business Portfolio\
   You need to have a Meta Business Portfolio to use the WhatsApp integration.

You can create a business portfolio at [Meta for Business](https://www.facebook.com/business/help/1710077379203657).

2. Prepare a phone number for WhatsApp Business\
   Make sure you have a phone number available that hasn't previously been registered with WhatsApp Business.

<Steps>
  <Step>
    <h3>Go to Tools in your chatbot portal</h3>

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/en/wha.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=976cbaf29c39422be429b87a3951454a" alt="Integrations" width="1918" height="936" data-path="images/integrations/whatsapp/en/wha.png" />
    </Frame>
  </Step>

  <Step>
    <h3>Connect your Meta Business Portfolio with Doko</h3>

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/en/conecta-facebook.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=841eb3811524e827789d46a5ced75867" alt="FB Session" width="1181" height="182" data-path="images/integrations/whatsapp/en/conecta-facebook.png" />
    </Frame>
  </Step>

  <Step>
    <h3>Complete the login with Facebook</h3>

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/conecta-empresa.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=1f4ba184477f324f42cbab353d7ef827" alt="Connect Company" width="1116" height="1328" data-path="images/integrations/whatsapp/conecta-empresa.png" />
    </Frame>

    Complete your business portfolio information.

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/conecta-portafolio.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=0e682db58b47201c88fbfb0029192348" alt="Connect Portfolio" width="1116" height="1328" data-path="images/integrations/whatsapp/conecta-portafolio.png" />
    </Frame>

    ### Option 1: Create WhatsApp Business Profile

    Create your WhatsApp Business account.

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/conecta-wa.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=acdc884afe80d5263e266682529459c6" alt="Connect WA" width="1116" height="1328" data-path="images/integrations/whatsapp/conecta-wa.png" />
    </Frame>

    Enter your company details.

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/crea-wa.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=04d879caaad204b990b28e3dade29ba8" alt="Create WA" width="1116" height="1328" data-path="images/integrations/whatsapp/crea-wa.png" />
    </Frame>

    ### Option 2: Connect WhatsApp Business

    Enter your phone number to start the connection.

    <Frame>
      <img src="https://mintcdn.com/doko/SDxkgB6wCx0K4Ff-/images/integrations/whatsapp/ingresa-num.png?fit=max&auto=format&n=SDxkgB6wCx0K4Ff-&q=85&s=c5e9d6e343736a19d83b873d2c59f4fd" alt="Connect WA" width="692" height="831" data-path="images/integrations/whatsapp/ingresa-num.png" />
    </Frame>

    When Facebook verifies your phone number, it will take you to the next step. To confirm that you are the business owner, it will display a QR code on screen to scan and verify, but it often throws an error when generating it.

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/error.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=0cb6a509f89fa282ffc8a72781e4942b" alt="Connect WA" width="701" height="833" data-path="images/integrations/whatsapp/error.png" />
    </Frame>

    <Danger>
      To fix the error, you must select the "Back" option to return to the previous page and re-enter the phone number.

      If you select the <i>"Add a new WhatsApp number"</i> bar, you can choose the profile you created to proceed to the next part of the integration.
    </Danger>

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/error-solucion.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=da88ef8e302e5cf5c37da1a4f9ab65de" alt="Connect WA" width="698" height="830" data-path="images/integrations/whatsapp/error-solucion.png" />
    </Frame>
  </Step>

  <Step>
    <h3>Set up a payment method</h3>
    <Warning>This step is required by Meta to be able to talk to your chatbot.</Warning>

    Please verify your payment methods to continue with the onboarding process.

    You can follow this article to add a payment method to your WhatsApp Business account: [Add payment methods to your account](https://www.facebook.com/business/help/488291839463771)
  </Step>

  <Step>
    <h3>Start chatting with your chatbot</h3>

    <Frame>
      <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/en/whaIntegration.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=2003b9675527918d90804f9b4fb97529" alt="Chat Bot" width="1918" height="936" data-path="images/integrations/whatsapp/en/whaIntegration.png" />
    </Frame>
  </Step>
</Steps>

### Live Mode

Live mode is a useful tool that allows the conversation to be transferred to a human agent.\
When activated, the bot automatically deactivates, allowing the agent to reply directly to the client’s messages.

Live chat only has two states:

* **Enabled:** any message sent to the client through WhatsApp Business will activate live mode, stopping bot responses.
* **Disabled:** requires you to manually set up an activation phrase so that when the admin sends it, the user can communicate with a human agent for support.

<Frame>
  <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/en/confModoVivo.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=3c5b39201ac76d714536aac6809617b0" alt="Chat Bot" width="1141" height="497" data-path="images/integrations/whatsapp/en/confModoVivo.png" />
</Frame>

### Reactivation

Set a phrase so users can automatically reactivate the chatbot from live mode.\
This phrase will disable live mode until further notice, allowing the bot to take control of the conversation again.

The message just needs to contain the configured phrase.

<Tip>
  You can set up quick replies in WhatsApp Business to make it easier for users to send the exact phrase. [Learn how to set up quick replies](https://www.facebook.com/business/help/).
</Tip>

<Frame>
  <img src="https://mintcdn.com/doko/0YZZ6sTrgbzUs9Ha/images/integrations/whatsapp/en/frase.png?fit=max&auto=format&n=0YZZ6sTrgbzUs9Ha&q=85&s=1b2a3ba9974d525f8488775a9b846019" alt="Chat Bot" width="1167" height="278" data-path="images/integrations/whatsapp/en/frase.png" />
</Frame>

## Next steps

<Card title="WhatsApp Templates" icon="whatsapp" href="../messages/templates">
  Learn how to create and manage WhatsApp templates for your follow-ups and campaigns.
</Card>
