Skip to main content

​
Prerequisites

  • A HookMyApp account.
    Sign in with hookmyapp login.
  • A Facebook Page you manage.
    Personal profiles cannot be connected.

​
Connect from the dashboard

Open your workspace’s channels page, click Connect Channel, then Facebook.
Sign in to Facebook, then pick the Page from the picker.
HookMyApp handles the permissions. From the terminal, hookmyapp channels connect facebook opens that page for you and waits for the new channel. A Page with a linked Instagram account also connects that account as its own instagram channel in the same workspace.
The two channels are managed separately after that: each has its own token, webhook destination and forwarding switch.

​
What you get back

  • Channel ID (ch_xxxxxxxx): use it in channel commands, like hookmyapp channels webhook set <channel> and hookmyapp channels health <channel>.
    Find it with hookmyapp channels list.
  • Channel token: the hmat_ token your app sends in the Authorization: Bearer header.
    Get it with hookmyapp channels token <channel>, or copy it from the channel page.
  • Page ID: the id used in the send URL. hookmyapp channels show <channel> prints it.

​
Token lifetimes and rotation

Your channel token does not expire.
If the Page loses permission to send, the channel health page shows it and Reconnect on the channel page re-links the Page. If your channel token leaks, rotate it: hookmyapp channels token <channel> --rotate, or the Rotate button on the channel page.
The old token stops working immediately.

​
Reconnect

Open the channel’s detail page in the dashboard and use Reconnect. The channel updates in place and messages keep flowing throughout.
Reconnecting the Page also refreshes the Instagram channel that was connected with it.

​
Disconnect

Disconnect on the channel page, or hookmyapp channels disconnect <channel>.
Disconnecting the Page leaves the linked Instagram channel connected. Disconnect it separately if you want both gone.

​
Next steps