Objective
To create and automate a custom tool in the AI Assistant that sends links during calls when requested. This enables real-time information sharing through SMS while maintaining conversation flow during voice interactions.Benefits
- ✅ Real-time link sharing during active phone conversations
- ✅ Seamless user experience without interrupting call flow
- ✅ Automated SMS delivery triggered by natural language requests
- ✅ Contact logging for tracking sent information
- ✅ Enhanced customer satisfaction through instant resource delivery
- ✅ Flexible content delivery supporting various link types and resources
Step 1: Create the Custom Tool
Navigate to AI Assistant Settings
- Go to AI Assistant Settings
- Click on Tools and Abilities
- Select Create Custom Tool
Configure Tool Details
Tool Configuration:
- Unique Name:
sms_content
- Description:
- Trigger: Activated when the user asks for a link or information to be sent via SMS
Parameter Configuration:
- Parameter Name:
sms_content
- Description: “The text message or link(s) that need to be sent to the user via SMS. This includes any resources, links, or information the user has requested during the conversation.”
Initial Save
- Click Save (The Endpoint URL will be added later)
- Add appropriate prompts to guide the AI in calling the tool
- Configure the AI to recognize SMS requests and trigger the tool
AI Prompt Example:
Step 2: Set Up the Automation Workflow
Create Workflow
- Go to Automations and click Create New Workflow
- Name the workflow: “Custom Tool - Send SMS During Call”
Configure Trigger
- Add a Trigger: Select Inbound Webhook as the trigger type
- Copy the Webhook URL provided
- Return to the custom tool and paste this Webhook URL into the Endpoint URL field
- Save the workflow
Step 3: Create a Custom Field (Optional Logging)
Field Configuration
- Navigate to Custom Fields
- Create a new field with the following details:
- Field Type: Multi-line Text
- Field Name:
sms_sent
- Purpose: Track SMS content sent to contacts for logging and reference
Benefits of Logging
- Track what information was sent to each contact
- Maintain conversation history
- Enable follow-up opportunities
- Support customer service queries
Step 4: Link the Automation to SMS Sending Action
Workflow Configuration Guide
🔹 Step 1: Trigger Setup
- Trigger Type: Inbound Webhook
- Purpose: Initiates the workflow when called from your custom tool
- Configuration: Get the payload reference by making a test call
🔹 Step 2: Add Wait Action
- Action: Wait
- Duration: 0.3 minutes
- Purpose: Allows any asynchronous processes to complete before proceeding
🔹 Step 3: Find Existing Contact
- Action: Find Contact
- Search Fields Configuration:
- Contact ID: Map to
Inbound webhook trigger → Call → Call id
- Phone: Map to
Inbound webhook trigger → Call → From_number
- Contact ID: Map to
🔹 Step 4: Conditional Branch – Contact Found?
If Contact Is Found:
- Add Wait: 0.2 minutes
- Action: Update Contact Fields
- Field Mapping:
sms_content
→ Map to SMS content from custom valuesphone
→ Map to contact phone number
If Contact Is Not Found:
- Add Wait: 0.2 minutes
- Action: Create New Contact
- Initial Field Mapping:
sms_content
→ Map to SMS from custom valuesphone
→ Map to contact phone number
- Action: Update Contact Fields
- Additional Field Mapping:
sms_content
→ Map to SMS from custom valuesphone
→ Map to contact phone number
🔹 Step 5: Send SMS
- Action: Send SMS
- Message Template:
- Dynamic Fields: Use webhook data to include specific links or additional details
Optional Enhancements
Additional Actions:
- Send Email with the same documentation link for backup reference
- Send Internal Notification for tracking or team visibility
- Create Task for follow-up if needed
Optimization Tips:
- Combine actions after branching to avoid duplicates
- Consolidate optional actions (email/notifications) after contact creation or update
- Use consistent field mapping throughout the workflow
Step 5: Final Testing and Deployment
Testing Process
Simulate Real Scenarios:
- Initiate a test call and simulate a user request like:
- “Can you text me the link?”
- “Please send me that documentation via SMS”
- “Could you message me the website address?”
Verification Checklist:
- ✅ Tool Detection: Ensure the tool detects SMS requests correctly
- ✅ SMS Delivery: Confirm SMS is sent with correct content
- ✅ Content Accuracy: Verify links and information are properly formatted
- ✅ Logging Functionality: Check that interactions are logged (if applicable)
- ✅ Contact Management: Ensure contacts are created or updated properly
Quality Assurance
Test Different Scenarios:
- Existing contacts receiving SMS links
- New contacts being created during the process
- Various link types (documentation, websites, resources)
- Multiple requests during a single call
- Error handling for failed SMS delivery
Performance Monitoring:
- Response time from request to SMS delivery
- Success rate of SMS delivery
- User satisfaction with link accessibility
- System reliability under various conditions
Implementation Examples
Common Use Cases
Documentation Sharing:
User Request: “Can you text me the user guide?” AI Response: “I’ll send you the user guide link right now via SMS.” SMS Content: “Here’s your user guide: https://docs.buildassistants.app/user-guide”Resource Links:
User Request: “Please send me that pricing page” AI Response: “I’m sending you the pricing information via text message.” SMS Content: “Here’s our pricing page: https://buildassistants.app/pricing”Support Documentation:
User Request: “I need the troubleshooting guide texted to me” AI Response: “I’ll text you the troubleshooting guide immediately.” SMS Content: “Troubleshooting guide: https://docs.buildassistants.app/troubleshooting”Advanced Configuration
Dynamic Content Delivery
- Context-aware links based on conversation topic
- Personalized messages with user-specific information
- Multiple link sharing in a single SMS
- Follow-up sequences for comprehensive resources
Integration Enhancements
- CRM synchronization for complete contact history
- Analytics tracking for link engagement
- A/B testing for message effectiveness
- Multi-channel delivery (SMS + Email)
Troubleshooting
Common Issues
Tool not triggering:- Verify webhook URL is correctly configured
- Check AI prompts for SMS request recognition
- Ensure tool is properly linked to assistant
- Confirm phone number formatting is correct
- Verify SMS service is properly configured
- Check webhook payload for required fields
- Review parameter mapping in workflow
- Verify dynamic field references
- Test with various content types
- Check conditional logic in workflow
- Verify contact field mappings
- Ensure proper error handling
Performance Optimization
Reduce Latency:- Optimize wait times in workflow
- Streamline conditional logic
- Use efficient field mapping
- Add error handling for failed SMS
- Implement retry mechanisms
- Monitor delivery success rates
Security Considerations
Data Protection
- Secure link sharing with appropriate access controls
- Contact information privacy in accordance with regulations
- SMS content filtering to prevent sensitive data exposure
- Audit trails for compliance tracking
Best Practices
- Validate phone numbers before sending SMS
- Encrypt sensitive links when necessary
- Implement rate limiting to prevent abuse
- Monitor usage patterns for security anomalies