Typebot and Uzapi: WhatsApp integration setup
Learn to connect Typebot to Uzapi using a base URL override, instance credentials and a callback URL, then test a WhatsApp flow with buttons.
Player not loading? Watch on YouTube
This tutorial explains how to connect Typebot to the Uzapi WhatsApp API through Typebot's built-in WhatsApp connector. The presenter starts with a running Typebot deployment and an existing Uzapi instance linked to a phone number. Creating that instance is outside the walkthrough.
The setup begins with an environment variable: WHATSAPP_CLOUD_API_URL=https://api.uzapi.com.br/username. The presenter instructs viewers to replace the username, add the variable to both the Typebot builder and viewer, and update the stack. He explains that this overrides the connector's default base URL so the credential helper checks the Uzapi token against the intended endpoint. Portainer is the deployment interface used in the example.
After creating a flow from a template, the presenter opens the WhatsApp sharing options and enters the instance token, business account ID and phone number ID. He copies Typebot's generated callback URL into the Uzapi instance's webhook settings, saves it, activates the integration and publishes the flow.
The WhatsApp test starts with a greeting, then collects a name and email address. The presenter also demonstrates selectable responses and says Uzapi supports buttons and option lists. The example connects a self-hosted Typebot flow to the hosted Uzapi messaging API.