Whatsapp Verification
Last updated
Last updated
WhatApp Verification (SendTalk 2.0) is a method of verification that requires a customer to send a WhatsApp message to SendTalk’s WhatsApp Official Business Account to trigger the verification process for the customer.
Below is the sample process that we recommend our clients to use if they are planning on using WhatApp Verification as a verification method for their applications.
Recommended Verification Flow:
User Login User initiates a login on client's application using phone number that is registered to WhatsApp.
Request Verification Client's application will trigger client's backend server to request create verification to SendTalk's server through API call.
Return Payload Once SendTalk's server receive an API call from client's server, SendTalk will process the verification request and return a payload containing:
Verification ID
WhatsApp message link
WhatsApp message
QR code
We suggest clients to save this verification ID to their own database along with a verification status.
WhatsApp Message Link WhatsApp message link is a link that can be accessed by a customer to redirect them to a chatroom in their WhatsApp application where the recipient will be SendTalk's WhatsApp Official Business Account and a predefined message template will show up on their text composer. After receiving the WhatsApp Message Link from SendTalk's server, we suggest clients to redirect their users to this link. Try creating your own Deep Link with these documentations: iOS : https://docs.taptalk.io/powertalk-chat-sdk-documentation/powertalk-ios/deep-linking Android : https://docs.taptalk.io/powertalk-chat-sdk-documentation/powertalk-android/deep-linking
Send WhatsApp Message After users are redirected to the link and to WhatsApp, users must send the message without changing the content to trigger the verification checking from SendTalk. There is an instruction in the template message that ask the users to go back to the application that triggered the verification process.
Validate SendTalk will validate every message received in SendTalk's WhatsApp Official Business Account.
Webhook URL SendTalk will send a Webhook call to registered Webhook URL if a verification succeeded. Clients can update the verification status on their database based on the payload from Webhook.
Verification Status Client can trigger a verification check to their database right after the user went back to the application.
Go to https://sendtalk.taptalk.io and login if you already have an account.
Browse to "WhatsApp Verification" > "Verification Config" and click "Edit" to enable your WhatsApp Verification.
Enable the WhatsApp Verification, input your Webhook URL ans click "Save Changes".
Once saved, a Secret key will be generated and you can use this as a validator for this webhook call. WhatsApp Verification is ready to use.
POST
https://sendtalk-api.taptalk.io/api/v1/verification/create_whatsapp_verification
userPhone
string
The phone number to be verified.
languageCode
string
Language code for the generated verification message. Values: "en"
, "id".
expiryMinutes
integer
(Optional) The expiry duration in minutes.
appURL
string
(Optional) App link/URL to be included in the generated verification message.
success
boolean
If created successfully.
message
string
The success or error message.
reason
string
Failure reason ("invalid_recipient", "insufficient_balance", "config_disabled").
verification
object
The created verification, if successful.
id
string
The verification ID.
waLink
string
WhatsApp link containing recipient number and generated message.
waMessage
string
The generated message.
qrCode
string
QR code for the WhatsApp link.
ParamValidationFailed
The parameter validation failed.
HeaderValidationFailed
The request header validation failed.
Below document will describe the details of a WhatsApp Verification Webhook payload that will be sent every time a verification has been verified via a POST API Call to client's Webhook URL.
id
string
The ID of the verification.
userPhone
string
The phone number to be verified.
status
string
The verification status ("verified").
verifiedTime
long
The verified time, in Unix milliseconds.
To help you implement WhatsApp Verification smoothly, you can check our Client Examples for using SendTalk by clicking this link https://github.com/taptalk-io/sendtalk-client-example/tree/main
For more information feel free to contact us via support@taptalk.io or simply click the link below to chat from WhatsApp.