Skip to content

Channels

Connecting WhatsApp

Connect your WhatsApp Business number to Talkty and handle messages in the inbox.

Once WhatsApp is connected, your customers' WhatsApp messages land in Messages, where you reply, let your AI assistant answer and link the conversation to the Sales CRM.

Before you start

  • You need a Facebook account and a Meta Business account (one is created during connection if you don't have it).
  • The phone number you connect may receive an SMS or call for verification; keep it at hand.
  • If the number is connected to another WhatsApp Business API provider, disconnect it there first.

Connecting

  1. In Messages, pick WhatsApp in the channel filter at the top left (or open the WhatsApp card under Settings › Channels & integrations › Channels).
  2. Press Connect a new number (if your number is used in the WhatsApp Business app, see the next section). Meta's setup window opens.
  3. Sign in with Facebook, choose (or create) your business and select your WhatsApp Business account.
  4. Add and verify your phone number.
  5. When the window closes, the channel shows as connected and incoming messages start appearing.

If the window doesn't open, allow pop-ups for this site in your browser.

Connecting your WhatsApp Business app number

You can keep your number and keep using the phone app; messages appear both on the phone and in Talkty.

Requirements: WhatsApp Business app 2.24.17 or later, the number active in the app, and your phone at hand.

  1. On the connect screen, press Connect my WhatsApp Business app number.
  2. Follow the steps in Meta's window and approve from your phone. You choose whether to share your chat history.
  3. Your contacts and the last 180 days of chats start importing. You can see the status on the WhatsApp connection card and under Settings › Channels & integrations › Channels.

What changes on the phone:

  • Linked devices (WhatsApp Web, desktop) are signed out; you can link them again. The Windows app and WearOS are not supported.
  • Broadcast lists are turned off; existing ones become read-only.
  • Disappearing messages, view-once messages and live location are turned off in one-to-one chats.
  • Groups are not imported into Talkty; they keep working on the phone.

The sync happens once: contact and history sync can run within 24 hours of connecting, and each only once. If Meta did not accept the request, Try again appears on the card. After it is accepted, or after 24 hours, repeating it requires disconnecting in the phone app under Settings › Account › Business Platform (Disconnect Account) and connecting the number again.

What is imported:

  • Chats are added with their real dates, up to the latest 500 messages per chat. Images open only for the last 14 days.
  • Imported chats do not count as unread; AI does not reply, automations and campaigns do not run, no Sales CRM card opens and no tokens are spent. When the customer writes a new message, the chat continues as usual.
  • Contacts are matched by phone number, so the same number isn't added twice. If your plan's contact limit is full, the card shows how many could not be added. A contact you delete from your phone is not deleted from Talkty.
  • If you declined to share history, the card says Not shared.
  • Messages you write from the phone are added to the chat and don't trigger AI; if Pause AI when you reply from your phone is on in inbox settings, AI stays quiet in that chat for the set time.

Messages sent from the phone carry no Meta charge; messages sent from Talkty follow Cloud API pricing and the 24-hour rule. Sending speed is limited to 20 messages per second.

Connecting with manual details

If you can't use the Meta window (for example, with the test number in the Meta developer dashboard), click Connect with manual details on the WhatsApp connect screen and enter:

  • Phone number ID: the long number shown under your phone number in Meta › WhatsApp › API Setup.
  • Access token: the permanent token you created for a system user in Meta Business settings.
  • WABA ID (optional): your WhatsApp Business account ID; needed for template sync.

A test number can only message numbers you added as allowed recipients in Meta.

Connecting with a QR code

If enabled on your installation, you'll also see Connect WhatsApp (QR): press it and a code appears on screen; on your phone, tap WhatsApp › Settings › Linked devices › Link a device and scan that code. The connection stays open even when the system is updated or restarted.

This method is not WhatsApp's official business infrastructure; there is a risk of the account being restricted (banned) and the number of messages per minute is limited. For long-term use we recommend the official connection above. If the session drops, reconnect with Generate a new QR.

The 24-hour rule

WhatsApp only lets you send free-form messages within 24 hours of the customer's last message. After that, you can only write to them with a template message approved by Meta. See WhatsApp templates.

Disconnecting

Open the WhatsApp tab on the Messages screen (with no conversation selected) and press Sign out / Disconnect, or press Disconnect on the WhatsApp card under Settings › Channels & integrations › Channels. Past conversations are not deleted.

Common issues

  • Messages aren't arriving: check the channel status and the "Errors in last 24h" count under Settings › Channels & integrations › Channels. See Channel management and health.
  • "Meta Embedded Signup is not configured yet": the official connection isn't enabled on this installation yet; contact our support team.