Skip to main content
◈hastdocs
English
Hast home

AIP

Connect WhatsApp

Let customers ask questions, share files, and get replies from your Agent in WhatsApp.

Before you start

New WhatsApp channels created in the AIP console use Dualhook. Your FDE helps you connect your own Dualhook organization and WhatsApp Business account. The account holder must complete authorization.

Use the existing channel if this Profile already has the account. Adding it to a knowledge base does not require another authorization. Prepare an enabled Agent if you need automatic replies.

1

Prepare account authorization

Follow the Dualhook account setup guide to prepare your organization and WhatsApp Business account. Confirm the account and number for this connection.

To import history, select it during initial WhatsApp authorization and request it within 24 hours of onboarding. Available records can cover up to 180 days before onboarding. The provider determines availability; groups and all historical media are not included.

2

Create the channel in AIP

Open Channels → Add channel and select WhatsApp. Enter a name, select whether to import available history, and click Prepare channel.

AIP shows a callback URL and verification token. If setup is incomplete, use Finish setup in the channel list to continue.

3

Configure the message callback

Enter the complete AIP callback URL and verification token in the current Dualhook organization's setup, then complete account authorization. Keep both values private.

Use the callback for this channel. Do not replace an existing account's callback with another account's values.

4

Save account details

Enter the WABA ID and Phone Number ID supplied for this Dualhook connection in AIP. These identify the account and number; they are not the phone number itself.

Get an Outbound API key

Follow the Dualhook Runtime API guide to obtain the organization's Outbound API key. Enter it in the matching field and click Save account details. This field uses the Dualhook outbound API credential.

AIP then shows Account configured. Provider callbacks update history status. Media can arrive after the status says history messages have been received.

5

Associate an Agent and test

New content syncs automatically. Knowledge sync does not require an Agent. Open View content for the channel and check for new messages. Add the source to a knowledge base when you need retrieval.

For automatic replies, associate this connection in the Agent's Channels settings and save. Enable the Agent. Send a message from another WhatsApp number and confirm the reply in that conversation, then test an image or file. Configure channel associations and knowledge access separately.

Existing Meta connections

You can maintain an existing WhatsApp channel that connects directly to Meta. Use Reauthorize on that channel. Enter the original account's phone_number_id, business_account_id, token_secret_value, and app_secret_value, save, and test messages. The token and App Secret must belong to the same Meta app, with access to the target WABA.

Existing Meta connections and new Dualhook connections use different credentials. Keep the account and callback when updating an existing connection. Do not create a duplicate channel to renew credentials.

Troubleshooting

Setup is still incomplete

Open Finish setup or Account setup in Settings. Check the current Dualhook organization's callback, WABA ID, Phone Number ID, and Outbound API key, then save account details.

Connected, but no reply

First check View content for new messages. Then check that the Agent is enabled, associated with this channel, and allowed by the channel's trigger rules. Knowledge sync does not enable automatic replies.

History is incomplete

Check whether history was requested during initial authorization and inspect the provider's progress. The import has time and content limits. Not all media is available; do not create a second source through repeated authorization.

Meet HastLearn about Hast AIP, Hast Agent, Hast GTM, and delivery with the FDE team.About AIPConfigure Agents and connect business systems using the FDE delivery workbench.Create your first AgentConfigure, save, and debug an Agent without external services.Configure and manage AgentsSet responsibilities, models, and capabilities, and maintain the active configuration.Manage SkillsWrite, import, and select the skill files used by Agents.Add a knowledge baseOrganize URL, file, and Drive sources; manage knowledge-base membership, indexing, and compiled material.Manage business secretsStore credentials and bind them to Agents without exposing real values in examples.Connect business toolsLet Agents call HTTP services with explicit inputs and authentication.Configure long-term memoryChoose what memory an Agent can read and where new memory is written.Debug an AgentTest saved configurations, conversation continuity, and tool results.Import, export, and copyReuse configurations and recheck resources and credentials after migration.Webhook HTTP integrationInvoke an Agent from your server, continue conversations, read replies, and stop execution.MCP integrationConnect external Agent clients to AIP tools with a Public API Key.Connect SlackBring your Agent into Slack to ask questions, work with files, and collaborate with your team in channels or direct messages.Connect WhatsAppLet customers ask questions, share files, and get replies from your Agent in WhatsApp.Connect WeChat Customer ServiceConnect your Agent to WeChat Customer Service to answer customers in WeChat.API quickstartCreate an AIP key, call a saved Agent, read replies, and access authorized business resources.Conversation events and SSEPoll single-Agent conversation events or stream ordinary task events with a Profile API key.API referenceExplore AIP public API authentication, Agent conversations, and business resource endpoints.About Task AgentPlan, execute, and deliver complete tasks with tools, files, and lasting context.Complete your first taskSubmit a request, check progress, and inspect the final output.Execute tasks and manage conversationsAdd instructions, stop execution, and manage conversation history.Upload, view, and download filesProvide inputs and keep the files created by your tasks.Connect apps and configure capabilitiesAuthorize external apps and maintain context across tasks.Create scheduled tasksSet recurrence and timezone, then inspect each run's result.Task Agent troubleshootingCheck access, connections, task state, and files.About GTMUse a shared website project for research, visibility analysis, and marketing drafts.Create your first GTM projectEnter a website, wait for initialization, and inspect the first results.Manage projects and website contextSwitch projects, refresh site information, and manage project settings.Company analysis and project documentsReview product, competitor, and marketing context before content tasks.SEO and website performanceRead PageSpeed reports for mobile and desktop.AI brand mentionsInspect buyer questions and whether model answers mention your brand.Connect Google AnalyticsAuthorize an account, choose a GA property, and inspect traffic reports.Generate and publish X draftsCreate posts, review previews, and finish publishing on X.Generate article draftsSet style, language, and audience, then review and copy Markdown.Use Growth AgentRead project context or start supported background operations in conversation.Run status and troubleshootingCheck queueing, dependencies, and results without treating unfinished work as missing data.Plans and usageCheck access, consumption, and billing for the current Profile.