Skip to main content

Connectivity Checklist

Connect at least one channel before your AI agent can handle conversations.

WhatsApp​

  • Create a Meta Business account at business.facebook.com
  • Apply for WhatsApp Business API access in Meta Business Manager
  • Obtain a Phone Number ID and a permanent access token from Meta
  • In Squawkpipe: go to Settings → Channels → WhatsApp
  • Enter your Phone Number ID and access token
  • Send a test message to verify connectivity
WhatsApp 24-hour window

WhatsApp only allows outbound messages within 24 hours of the customer's last inbound message. If the window has closed, the agent will add an internal note rather than attempting delivery.

Email​

  • In Squawkpipe: go to Settings → Channels → Email
  • Set your inbound email address (the address customers write to)
  • Set your outbound email address (the address replies are sent from)
  • Configure email forwarding or a webhook to route inbound email to Squawkpipe
  • Send a test email to verify inbound and outbound routing

Success vs. Error States​

StateWhat you see
ConnectedGreen indicator in Settings → Channels
Delivery failedRed indicator; internal note added to conversation
WhatsApp window closedInternal note: "Messaging window closed"
Invalid credentialsRed indicator; error shown in Settings

API Keys​

  • Go to Settings → API Keys
  • Click Generate new key
  • Copy the key immediately — it is shown only once
  • Store securely (secrets manager, not source code)
  • Pass to the CLI: squawk api-key or set SQUAWK_API_KEY