Documentation
Updated: 8th June 2024
User Documentation
Setting Up Whatsapp Cloud API
To start setiing up your Whatsapp Cloud API, you need to first navigate to Swiftchats Settings section and get the Webhook URL and Verify Token values which we'll use in the subsequent steps.
Step 1: Create a Facebook Developer Account
To start using Swiftchats for sending whatsapp messages, you must first connect the Whatsapp Cloud API. If you don't have a Facebook developer account, you will need to create one as outlined below.
- Click on this link for instructions on how to create a Developer account and a new Facebook app.
- Once your Facebook app is created, navigate to the app dashboard and locate the WhatsApp product. Proceed to the Setup section and take note of the
APP ID. - Access WhatsApp > Configuration and input the callback URL and token values.
- Click on Webhook fields -> Manage and select Messages.
Step 2: Obtain Your Permanent Access Token
- Refer to the detailed process outlined in the Facebook Docs to create a permanent access token.
- Once you have the permanent access token, save it for use in your app.
Step 3: Obtain Your Account ID and Phone Number ID
- In the Facebook app, navigate to WhatsApp -> API setup to locate your
Phone Number IDandWhatsApp Business Account ID.
Step 4: Add Whatsapp Details To Your Dashboard
- Go to your Swiftchats user dashboard, navigate to Settings or click on Setup Whatsapp.
- Click Edit and add the following information as obtained above:
- App ID
- App Secret
- Access Token
- Phone Number ID
- Whatsapp Business Account ID
- Click Save
Creating and Syncing Whatsapp Templates
Swiftchats facilitates the creation of WhatsApp templates categorized into utility and marketing types. Here's an overview of each, along with associated restrictions:
-
Utility Templates: These templates are essential for delivering practical information, such as transactional notifications, account updates, appointment reminders, and delivery confirmations. However, utility templates are subject to stricter guidelines and limitations, including:
- They must adhere to WhatsApp's policies regarding transactional messages.
- Utility templates should not contain promotional content or marketing language.
- Use of utility templates is typically restricted to specific types of messages, such as account-related notifications or service updates.
-
Marketing Templates: These templates are designed for promotional purposes, aiming to engage users and drive sales. While marketing templates offer more flexibility in terms of content and messaging, they are subject to certain restrictions, such as:
- Compliance with WhatsApp's policies regarding promotional messages and marketing content.
- Marketing templates must undergo a review process by WhatsApp to ensure compliance with guidelines.
Whatsapp Chat
Guidelines for Interaction through WhatsApp Cloud API
Swiftchats facilitates seamless communication with contacts through various message types, but adheres to guidelines established by the WhatsApp Cloud API. Here's what you need to know:
- Direct messaging initiation isn't supported; you must send a template message first.
- After the user responds to the template message, you can proceed with chatting.
- If there's no reply within 24 hours, the option to chat is disabled.
- To re-enable the chat option after it's disabled, you need to send another campaign message.
Managing Contacts & Contact Groups
Managing Contact Groups
Swiftchats enables you to organize your contacts into groups, simplifying management and filtering for campaign distribution.
- Navigate to the contacts section within the application.
- Select "Groups".
- Click on the "+" icon to add a new group
- Provide the necessary details for your group and click "Save".
Importing Contacts
To manage your contacts effectively, you can create, import, edit, and export them within the application.
- Navigate to the contacts section within the application.
- Click on the import icon.
- Download the provided sample import template.
- Customize the template by adding your contact information into the appropriate columns.
- Once your modifications are complete, upload the CSV file.
- Allow some time for the import process to finish.
- Verify that all contacts have been successfully imported.
Canned Replies/Automated Responses
With Swiftchats, you can send predefined responses to users triggered by specific keywords. The bot will automatically reply with the text, image, or audio content you've configured.