01
SMS auto-reply
- Inbound SMS arrives
- Persona classifies and answers
- Hands off to human if needed
17 tools available · 1 trigger
Enables interaction with customers through the WhatsApp Business API for messaging and automation. Only supports WhatsApp Business accounts, not WhatsApp Personal accounts.
Connect WhatsApp to Definable to auto-reply to inbound SMS, run targeted SMS campaigns, pipe voice → text → CRM. Personas call WhatsApp's 17 tools (and react to 1 trigger) directly from chat or scheduled flows. Hook this into a comms persona — answer inbound, run outbound, transcribe and route everything.
Common workflows with WhatsApp
02
Outbound campaign
- Build an audience
- Personalise per contact
- Send and track replies
03
Voice transcription pipeline
- Receive a call recording
- Transcribe and summarise
- Push the summary to your CRM
WhatsApp actions 17
Every WhatsApp action below is a callable tool any Definable persona can invoke.
Create message template
Create a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside the 24-hour window.
Delete message template
Delete a message template from the WhatsApp Business Account by name. This permanently removes the template and it cannot be recovered. When you delete a template by name, all templates with that name across all languages will be deleted. Names of deleted templates cannot be reused for 30 days. Important: Only delete templates that are no longer needed, as this operation is irreversible.
Get business profile
Get the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info.
Get media info
Get metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size. The download URL can be used to retrieve the actual media file.
Get message templates
Get all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages.
Get phone number
Retrieve detailed information about a specific WhatsApp Business phone number. Returns phone number details including verification status, quality rating, display number, verified business name, throughput limits, and webhook configuration. Use this to check phone number status, settings, and capabilities. To get available phone number IDs, first call WHATSAPP_GET_PHONE_NUMBERS.
Get phone numbers
Retrieve all phone numbers registered to your WhatsApp Business Account. Returns phone number IDs, display numbers, verification status, quality ratings, and messaging throughput limits. Use the phone number ID from the response to send WhatsApp messages via other API actions.
Get template status
Get the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review.
Send contacts
Send contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first.
Send interactive buttons
Send an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons. Perfect for yes/no questions, multiple choice selections, quick actions, or call-to-action scenarios. IMPORTANT REQUIREMENTS: - The recipient must be a registered WhatsApp user - The recipient must have messaged your business first within the last 24 hours (WhatsApp's customer service window) - You can include 1-3 buttons per message - Each button can have a title (max 20 chars) and unique ID (max 256 chars) Use cases: Customer service menus, appointment confirmations, feedback collection, product selections.
Send interactive list
Send an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option. Perfect for product catalogs, service menus, or guided workflows. Supports up to 10 sections with up to 10 items per section (100 total options). Note: Recipients must have messaged you first within the last 24 hours to receive this message.
Send location
Send a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API. The location message includes latitude/longitude coordinates, a location name, and address. Important: The recipient must have an active WhatsApp account. Additionally, you can only send free-form messages (like location messages) within the 24-hour customer service window after the recipient has initiated contact with your business. Outside this window, you must use approved message templates. Common error codes: - 133010: Recipient's phone number doesn't have a WhatsApp account - 131026: Message undeliverable (recipient may have blocked your business number) - 131047: Re-engagement message (outside 24-hour window, need to use template)
Send media
Send a media message to a WhatsApp number. Note: The media will be delivered to the recipient only if they have texted first.
Send media by
Send media using a media ID from previously uploaded media. This is more efficient than sending media by URL as the media is already on WhatsApp servers. Use upload_media action first to get the media ID. Note: The media will be delivered to the recipient only if they have texted first.
Send message
Send a text message to a WhatsApp user. Important: The recipient phone number must be registered on WhatsApp and must have initiated a conversation with your business within the last 24 hours, OR you must use a template message (see WHATSAPP_SEND_TEMPLATE_MESSAGE) for the first message outside the 24-hour window. For test accounts, recipient numbers must be added to the test recipient list in Meta Business Suite before sending messages.
Send template message
Send a template message to a WhatsApp number.
Upload media
Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers. The uploaded media gets a media ID that can be used in send_media or other messaging actions. Supported formats: - Images: JPEG, PNG (max 5MB) - Videos: MP4, 3GPP (max 16MB) - Audio: AAC, M4A, AMR, MP3, OGG (max 16MB) - Documents: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX (max 100MB) - Stickers: WebP (max 500KB, 512x512 pixels)
Brevo
Brevo (formerly Sendinblue) is an all-in-one email and SMS marketing platform that provides transactional messaging, marketing automation, contact management, and CRM tools to help businesses communicate and engage with their customers.
Callerapi
CallerAPI provides a white-label caller identification API that enhances customer trust, stops spam, fraud, and robocalls by offering branded caller ID solutions.
Callingly
Callingly is a lead response management software that automates immediate call and text follow-ups to new leads, integrating seamlessly with various CRMs and lead sources to enhance sales team responsiveness and conversion rates.
Callpage
CallPage is a lead capture tool that enables businesses to connect with website visitors through immediate phone callbacks, enhancing lead generation and sales conversion rates.
ClickSend
ClickSend is a cloud-based SMS and email marketing platform that enables businesses to send and receive SMS messages, manage contacts, and track campaign performance.
Convolo AI
Convolo.ai is an AI-powered communications platform designed to enhance sales calls and improve conversion rates through rapid lead response and integration capabilities.
Frequently asked questions
What can I automate with WhatsApp on Definable?
Anything WhatsApp exposes through its API. Common phone & sms workflows on Definable include auto-reply to inbound SMS, run targeted SMS campaigns, pipe voice → text → CRM. Personas can call any of the 17 WhatsApp tools directly, or react to its 1 trigger, then chain the result into another integration without you writing code.
How does WhatsApp authentication work?
WhatsApp uses OAUTH2, API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the WhatsApp integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 17 WhatsApp tools. You only need a separate WhatsApp subscription if WhatsApp itself charges per seat or per API call.
Is using WhatsApp through Definable secure?
Every call from a persona to WhatsApp is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with WhatsApp on Definable?
Sign up for Definable, open the integrations page, find WhatsApp, and connect via OAuth or API key. You can immediately attach WhatsApp to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What WhatsApp actions does Definable expose?
Definable exposes all 17 WhatsApp actions as callable tools — including `Create message template`, `Delete message template`, `Get business profile`, plus 14 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with WhatsApp?
Wire it up in minutes. No coding required.