# Soosh docs

> Guides and API reference for Soosh, WhatsApp for your whole business, by Voscart Labs. Every page below links to a plain Markdown version.

## Get started

- [What is Soosh](https://docs.soosh.io/get-started/what-is-soosh/index.md): One place for your team to talk to customers on WhatsApp, answer automatically and send campaigns.
- [Set up Soosh in four steps](https://docs.soosh.io/get-started/set-up-soosh/index.md): Connect your WhatsApp number, invite a teammate, get a template approved and send your first campaign.
- [Answer your first chat](https://docs.soosh.io/get-started/answer-your-first-chat/index.md): Reply to a customer, send a saved reply, leave a note for your team and message someone after 24 hours.
- [Build your first bot](https://docs.soosh.io/get-started/build-your-first-bot/index.md): Answer a common question automatically, teach the AI about your business and turn the chatbot on.
- [Make your first API call](https://docs.soosh.io/get-started/make-your-first-api-call/index.md): Create an API key, find a customer and send them a WhatsApp message from your own code, in about 10 minutes.

## Guides

- [Connect a WhatsApp number](https://docs.soosh.io/guides/workspace/connect-a-whatsapp-number/index.md): Link your business's WhatsApp number to Soosh through Facebook, so its chats arrive in your inbox.
- [Connect a number you use in the WhatsApp Business app](https://docs.soosh.io/guides/workspace/connect-a-number-you-use-in-the-app/index.md): Bring a number that's on the WhatsApp Business app into Soosh, keep using the app, and import your chats.
- [Invite a member](https://docs.soosh.io/guides/workspace/invite-a-member/index.md): Add a teammate to your workspace and choose what they can do.
- [Change a member's role](https://docs.soosh.io/guides/workspace/change-a-members-role/index.md): Give a teammate a different role, or remove them from your workspace.
- [Create a role](https://docs.soosh.io/guides/workspace/create-a-role/index.md): Make a role with exactly the permissions a job needs, like a support lead who can assign chats.
- [Create a team](https://docs.soosh.io/guides/workspace/create-a-team/index.md): Group agents so the bot, the AI and call menus can hand chats and calls to the right people.
- [Top up your wallet](https://docs.soosh.io/guides/workspace/top-up-your-wallet/index.md): Add money to your workspace's wallet by card or UPI.
- [Turn on auto-recharge](https://docs.soosh.io/guides/workspace/turn-on-auto-recharge/index.md): Top up the wallet automatically from a saved card whenever the balance runs low.
- [Set your time zone and date format](https://docs.soosh.io/guides/workspace/set-your-time-zone-and-date-format/index.md): Choose the time zone for schedules and reports, and how dates are written across Soosh.
- [Hide customers' phone numbers](https://docs.soosh.io/guides/workspace/hide-customers-phone-numbers/index.md): Show only the last 4 digits of customers' numbers to everyone in your workspace.
- [Read the audit log](https://docs.soosh.io/guides/workspace/read-the-audit-log/index.md): See who added, changed or removed something in your workspace, and when.
- [Sign in with single sign-on](https://docs.soosh.io/guides/workspace/sign-in-with-single-sign-on/index.md): Sign in to Soosh with your Google or company account instead of a password.
- [Reply to a customer](https://docs.soosh.io/guides/inbox/reply-to-a-customer/index.md): Answer a chat in the inbox, with text, a file or a reply to one of the customer's messages.
- [Reply after the 24-hour window](https://docs.soosh.io/guides/inbox/reply-after-the-24-hour-window/index.md): Message a customer who last wrote more than 24 hours ago, by sending an approved template.
- [Use saved replies](https://docs.soosh.io/guides/inbox/use-saved-replies/index.md): Send an answer your team has saved, with the customer's name filled in, by typing a slash.
- [Create a saved reply](https://docs.soosh.io/guides/inbox/create-a-saved-reply/index.md): Save an answer your team sends often, with blanks for what changes each time.
- [Add a private note](https://docs.soosh.io/guides/inbox/add-a-private-note/index.md): Leave a note on a chat that your team sees and the customer never does.
- [Assign a chat](https://docs.soosh.io/guides/inbox/assign-a-chat/index.md): Give a chat to one teammate, so they own the reply and it shows under Mine.
- [Pick up chats from the queue](https://docs.soosh.io/guides/inbox/pick-up-chats-from-the-queue/index.md): Take the next chat the bot or the AI handed to your team.
- [Use reply suggestions](https://docs.soosh.io/guides/inbox/use-reply-suggestions/index.md): Let the AI draft a reply to the chat, then check it, change it and send it.
- [See what Soosh remembers about a customer](https://docs.soosh.io/guides/inbox/see-what-soosh-remembers/index.md): Read the AI's notes on a customer before you reply, and correct them.
- [Run a chat action](https://docs.soosh.io/guides/inbox/run-a-chat-action/index.md): Use the buttons at the top of a chat to open the customer in your other tools.
- [Search chats and contacts](https://docs.soosh.io/guides/inbox/search-chats-and-contacts/index.md): Find a customer's chat by their name or number, or filter chats by tag.
- [Add a contact](https://docs.soosh.io/guides/contacts/add-a-contact/index.md): Add a customer by their WhatsApp number, so you can message them or send them campaigns.
- [Import contacts](https://docs.soosh.io/guides/contacts/import-contacts/index.md): Add many contacts at once from Excel, CSV, Google Contacts or your phone's contacts.
- [Tag contacts](https://docs.soosh.io/guides/contacts/tag-contacts/index.md): Group customers with tags like VIP or Wholesale, to filter chats and send campaigns.
- [Export contacts](https://docs.soosh.io/guides/contacts/export-contacts/index.md): Download your contacts as a CSV file for Excel or Google Sheets.
- [Create a template](https://docs.soosh.io/guides/templates/create-a-template/index.md): Write a message for Meta to approve, so you can start conversations and send campaigns.
- [Add an image, video or document](https://docs.soosh.io/guides/templates/add-an-image-video-or-document/index.md): Put a picture, video or PDF at the top of a template, like a sale banner or an invoice.
- [Add buttons](https://docs.soosh.io/guides/templates/add-buttons/index.md): Let customers answer, visit your site, call you or copy a code from a template in one tap.
- [Use variables in a template](https://docs.soosh.io/guides/templates/use-variables-in-a-template/index.md): Fill in each customer's name, order number or other details when the template is sent.
- [Get a template approved](https://docs.soosh.io/guides/templates/get-a-template-approved/index.md): Send a template to Meta for review, so you can use it in chats and campaigns.
- [Fix a rejected template](https://docs.soosh.io/guides/templates/fix-a-rejected-template/index.md): Find out why Meta rejected a template, change it and send it for review again.
- [Send a campaign to a tag](https://docs.soosh.io/guides/campaigns/send-a-campaign-to-a-tag/index.md): Send one approved message to every customer with a tag, like VIP, and track who reads and replies.
- [Send a campaign to an uploaded list](https://docs.soosh.io/guides/campaigns/send-a-campaign-to-an-uploaded-list/index.md): Send a campaign to numbers from a spreadsheet or your phone's contacts, even if they aren't contacts in Soosh yet.
- [Schedule a campaign](https://docs.soosh.io/guides/campaigns/schedule-a-campaign/index.md): Pick a day and time for a campaign to go out on its own.
- [Follow up automatically](https://docs.soosh.io/guides/campaigns/follow-up-automatically/index.md): Send a second message, a while after a campaign, to the people who didn't reply, read or tap a button.
- [Pause or cancel a campaign](https://docs.soosh.io/guides/campaigns/pause-or-cancel-a-campaign/index.md): Stop a campaign that's sending, for a while or for good.
- [Retry failed messages](https://docs.soosh.io/guides/campaigns/retry-failed-messages/index.md): Send a campaign's failed messages again, once you've fixed what stopped them.
- [Read campaign results](https://docs.soosh.io/guides/campaigns/read-campaign-results/index.md): See how many people got, read and answered your campaign, and who.
- [Set up keyword replies](https://docs.soosh.io/guides/chatbot/set-up-keyword-replies/index.md): Answer common questions automatically whenever a message contains certain words.
- [Add to the knowledge base](https://docs.soosh.io/guides/chatbot/add-to-the-knowledge-base/index.md): Teach the AI the facts it answers customers from, like delivery times, payment and returns.
- [Turn on AI answers](https://docs.soosh.io/guides/chatbot/turn-on-ai-answers/index.md): Let the AI answer customers from your knowledge base when no flow or keyword reply does.
- [Set business hours and an away message](https://docs.soosh.io/guides/chatbot/set-business-hours-and-an-away-message/index.md): Tell customers who write outside your opening hours when you'll be back.
- [Build a bot flow](https://docs.soosh.io/guides/chatbot/build-a-bot-flow/index.md): Walk customers through a conversation step by step, like checking an order or booking a fitting.
- [Hand chats to agents](https://docs.soosh.io/guides/chatbot/hand-chats-to-agents/index.md): Pass a chat from the bot to your team when a customer needs a person.
- [Create a WhatsApp form](https://docs.soosh.io/guides/chatbot/create-a-whatsapp-form/index.md): Make a form customers fill in without leaving WhatsApp, like a booking or a feedback form.
- [Send a WhatsApp form](https://docs.soosh.io/guides/chatbot/send-a-whatsapp-form/index.md): Send customers a published form from a chat, a template or a bot flow, and read their answers.
- [Turn on calling](https://docs.soosh.io/guides/calling/turn-on-calling/index.md): Let customers call your WhatsApp number, and your team call them back, from the browser.
- [Build a call menu](https://docs.soosh.io/guides/calling/build-a-call-menu/index.md): Greet callers and let them press a key to reach the right team, like "press 1 for orders".
- [Answer a call](https://docs.soosh.io/guides/calling/answer-a-call/index.md): Pick up a customer's WhatsApp call in the browser, and what you can do during it.
- [Make a call](https://docs.soosh.io/guides/calling/make-a-call/index.md): Call a customer on WhatsApp from their chat, once they've allowed calls.
- [Transfer a call](https://docs.soosh.io/guides/calling/transfer-a-call/index.md): Pass a call you're on to a teammate or a team.
- [Listen to a recording](https://docs.soosh.io/guides/calling/listen-to-a-recording/index.md): Find a past call and play its recording.
- [Call back missed calls](https://docs.soosh.io/guides/calling/call-back-missed-calls/index.md): Return calls from customers who didn't reach anyone, and play their voicemails.
- [Read your dashboard](https://docs.soosh.io/guides/analytics/read-your-dashboard/index.md): See how your WhatsApp workspace is doing at a glance, and add the numbers you care about.
- [See team performance](https://docs.soosh.io/guides/analytics/see-team-performance/index.md): See how quickly your team picks up and answers chats handed to them, agent by agent.
- [See WhatsApp insights](https://docs.soosh.io/guides/analytics/see-whatsapp-insights/index.md): See your customers, message delivery, Meta's charges and template performance in one place.
- [Track AI usage and cost](https://docs.soosh.io/guides/analytics/track-ai-usage-and-cost/index.md): See what the AI did for your workspace, what it costs, and cap it each month.
- [Create an API key](https://docs.soosh.io/guides/integrations/create-an-api-key/index.md): Give your own code access to Soosh, with only the permissions it needs.
- [Set up a webhook](https://docs.soosh.io/guides/integrations/set-up-a-webhook/index.md): Have Soosh tell your system the moment a message arrives, a contact is created or a chat is handed over.
- [Connect Shopify](https://docs.soosh.io/guides/integrations/connect-shopify/index.md): Show each customer's Shopify orders beside their chat, and send order updates on WhatsApp automatically.
- [Create a chat action](https://docs.soosh.io/guides/integrations/create-a-chat-action/index.md): Add a button to every chat that sends the customer to your other tools, like a helpdesk or order system.

## Feature overviews

- [Embedded Signup & Coexistence](https://docs.soosh.io/features/embedded-signup/index.md): Self-serve Meta onboarding — connect a WhatsApp Business Account via Facebook OAuth without copying tokens by hand
- [Roles & Permissions](https://docs.soosh.io/features/roles-permissions/index.md): Granular access control with customizable roles and permissions
- [Teams](https://docs.soosh.io/features/teams/index.md): Org-scoped agent teams that drive chat, chatbot, and call routing
- [Wallet & Payments](https://docs.soosh.io/features/wallet/index.md): Prepaid workspace balance with multiple payment providers and auto-recharge
- [SSO (Single Sign-On)](https://docs.soosh.io/features/sso/index.md): Configure OAuth-based single sign-on with Google, Microsoft, GitHub, Facebook, or any OIDC provider
- [Audit Logs](https://docs.soosh.io/features/audit-logs/index.md): Append-only record of who changed what, scoped per organization
- [Inbox & Chat](https://docs.soosh.io/features/inbox/index.md): The shared team inbox for two-way WhatsApp conversations — assignment, tags, notes, and message sending
- [Canned Responses](https://docs.soosh.io/features/canned-responses/index.md): Pre-defined quick replies for faster customer communication
- [Customer Memory](https://docs.soosh.io/features/customer-memory/index.md): The AI keeps a short note on each customer, so every agent knows the story before replying
- [Templates](https://docs.soosh.io/features/templates/index.md): Manage WhatsApp message templates
- [Campaigns](https://docs.soosh.io/features/campaigns/index.md): Send bulk messages to multiple contacts
- [Chatbot Automation](https://docs.soosh.io/features/chatbot/index.md): Automate customer conversations with intelligent chatbots
- [WhatsApp Flows](https://docs.soosh.io/features/whatsapp-flows/index.md): Build native WhatsApp interactive experiences
- [Calling](https://docs.soosh.io/features/calling/index.md): WhatsApp voice calling with IVR flow builder, call transfers, and recording
- [Dashboard](https://docs.soosh.io/features/dashboard/index.md): Monitor your WhatsApp business at a glance
- [Meta Insights & Analytics](https://docs.soosh.io/features/meta-insights/index.md): Proxied WhatsApp Business analytics from the Meta Graph API, cached in Redis
- [Outbound Webhooks](https://docs.soosh.io/features/webhooks/index.md): Subscribe external systems to Soosh events with signed, retried HTTP callbacks
- [Custom Actions](https://docs.soosh.io/features/custom-actions/index.md): Configure custom action buttons for quick integrations
- [Product Catalogs](https://docs.soosh.io/features/catalogs/index.md): Manage WhatsApp Product Catalogs by proxying Meta Commerce Manager

## Reference

- [API Overview](https://docs.soosh.io/reference/api/overview/index.md): Introduction to the Soosh REST API
- [Authentication](https://docs.soosh.io/reference/api/authentication/index.md): User registration, login, and token management
- [API Keys](https://docs.soosh.io/reference/api/api-keys/index.md): Create and manage API keys for programmatic access
- [Contacts](https://docs.soosh.io/reference/api/contacts/index.md): Manage contacts and contact information
- [Messages](https://docs.soosh.io/reference/api/messages/index.md): Send and receive WhatsApp messages
- [Tags](https://docs.soosh.io/reference/api/tags/index.md): Contact tag management API
- [Canned Responses](https://docs.soosh.io/reference/api/canned-responses/index.md): API reference for managing canned responses
- [Custom Actions](https://docs.soosh.io/reference/api/custom-actions/index.md): API endpoints for managing custom action buttons
- [Templates](https://docs.soosh.io/reference/api/templates/index.md): Manage WhatsApp message templates
- [Campaigns](https://docs.soosh.io/reference/api/campaigns/index.md): Send bulk messages to multiple contacts
- [WhatsApp Flows](https://docs.soosh.io/reference/api/flows/index.md): Manage WhatsApp Flows for interactive experiences
- [Catalogs](https://docs.soosh.io/reference/api/catalogs/index.md): Manage WhatsApp product catalogs and products
- [Chatbot](https://docs.soosh.io/reference/api/chatbot/index.md): Configure chatbot automation and AI responses
- [Calling](https://docs.soosh.io/reference/api/calling/index.md): Voice calling API — call logs, transfers, and outgoing calls
- [IVR Flows](https://docs.soosh.io/reference/api/ivr-flows/index.md): Manage Interactive Voice Response flows for WhatsApp calling
- [Webhooks](https://docs.soosh.io/reference/api/webhooks/index.md): Receive real-time updates from WhatsApp
- [Users](https://docs.soosh.io/reference/api/users/index.md): User management API
- [Organizations](https://docs.soosh.io/reference/api/organizations/index.md): Organization and member management API
- [Organization Settings](https://docs.soosh.io/reference/api/org-settings/index.md): Read and update organization settings and upload calling audio
- [Roles](https://docs.soosh.io/reference/api/roles/index.md): Role and permission management API
- [Teams](https://docs.soosh.io/reference/api/teams/index.md): Manage teams for chat routing and agent assignment
- [Accounts](https://docs.soosh.io/reference/api/accounts/index.md): Manage WhatsApp Business accounts
- [Audit Logs](https://docs.soosh.io/reference/api/audit-logs/index.md): Read the organization's record-level audit trail
- [Analytics](https://docs.soosh.io/reference/api/analytics/index.md): Access dashboard and messaging analytics
- [Dashboard Widgets](https://docs.soosh.io/reference/api/widgets/index.md): Build and manage custom analytics dashboard widgets
- [Export & Import](https://docs.soosh.io/reference/api/export-import/index.md): Bulk CSV export and import for contacts and tags