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

  1. Go to AI Assistant Settings
  2. Click on Tools and Abilities
  3. Select Create Custom Tool

Configure Tool Details

Tool Configuration:

  • Unique Name: sms_content
  • Description:
    This tool should be triggered whenever a user requests to receive links, resources, or any other information via SMS during an active conversation. It ensures that the requested information is instantly sent to the user's phone, providing a seamless experience. This tool is designed to handle any requests for links or details that need to be delivered quickly during a call, enhancing customer satisfaction and ensuring timely follow-ups.
    
  • 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

  1. Click Save (The Endpoint URL will be added later)
  2. Add appropriate prompts to guide the AI in calling the tool
  3. Configure the AI to recognize SMS requests and trigger the tool

AI Prompt Example:

When a user requests to receive links, documentation, or any information via text message during a call, use the sms_content tool to send the requested information immediately via SMS.

Step 2: Set Up the Automation Workflow

Create Workflow

  1. Go to Automations and click Create New Workflow
  2. Name the workflow: “Custom Tool - Send SMS During Call”

Configure Trigger

  1. Add a Trigger: Select Inbound Webhook as the trigger type
  2. Copy the Webhook URL provided
  3. Return to the custom tool and paste this Webhook URL into the Endpoint URL field
  4. Save the workflow

Step 3: Create a Custom Field (Optional Logging)

Field Configuration

  1. Navigate to Custom Fields
  2. 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

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

🔹 Step 4: Conditional Branch – Contact Found?

If Contact Is Found:
  1. Add Wait: 0.2 minutes
  2. Action: Update Contact Fields
  3. Field Mapping:
    • sms_content → Map to SMS content from custom values
    • phone → Map to contact phone number
If Contact Is Not Found:
  1. Add Wait: 0.2 minutes
  2. Action: Create New Contact
  3. Initial Field Mapping:
    • sms_content → Map to SMS from custom values
    • phone → Map to contact phone number
  4. Action: Update Contact Fields
  5. Additional Field Mapping:
    • sms_content → Map to SMS from custom values
    • phone → Map to contact phone number

🔹 Step 5: Send SMS

  • Action: Send SMS
  • Message Template:
    Here is the link to the documentation: {{custom_values.sms_content}}
    
    If you have any questions, feel free to reach out!
    
  • Dynamic Fields: Use webhook data to include specific links or additional details

Optional Enhancements

Additional Actions:

  1. Send Email with the same documentation link for backup reference
  2. Send Internal Notification for tracking or team visibility
  3. 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:

  1. 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
SMS not sending:
  • Confirm phone number formatting is correct
  • Verify SMS service is properly configured
  • Check webhook payload for required fields
Wrong content in SMS:
  • Review parameter mapping in workflow
  • Verify dynamic field references
  • Test with various content types
Contact creation issues:
  • 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
Improve Reliability:
  • 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

Result

The AI Assistant can now respond in real-time to SMS requests during calls, sending links or information via text and optionally logging the interaction for future reference. This creates a seamless experience where users can receive important resources without interrupting their conversation flow.