Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.meetzy.io/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Actions & Tools section is the powerhouse of your AI agent’s operational capabilities. Here you configure what your agent can do during and after calls - from transferring conversations to human agents or SIP systems, to making intelligent API calls, and setting up sophisticated callback protocols.
This section transforms your agent from a simple conversationalist into a fully integrated business automation tool that can take real actions and connect with your existing systems.

Call Transfer

Configure how your agent intelligently transfers calls to human agents, departments, or external phone systems when needed.

Transfer Configuration

1

Enable Transfer Capability

Toggle the “Call Transfer” option to activate the transfer functionality for your agent.
2

Choose Transfer Destination

Select between traditional phone numbers or SIP trunk endpoints based on your infrastructure.
3

Configure Transfer Logic

Define when and how your agent should initiate transfers using smart prompting.
4

Test Transfer Flow

Validate that transfers work correctly with your phone system before going live.

Transfer Types

Traditional Phone TransferPerfect for transferring to mobile phones, landlines, or traditional business numbers.
  • Format: Use international format (+1234567890)
  • Best for: Human agents, customer service departments, sales teams
  • Reliability: High compatibility with all phone systems
  • Cost: Standard telephony rates apply
Configuration Example:
Transfer Number: +1-555-123-4567
Department: Sales Team

Advanced Transfer Features

Context Preservation: Comprehensive information transfer to human operators:
  • Customer’s name, contact information, and call origin
  • Complete conversation summary with key discussion points
  • Specific questions, requests, or issues that triggered the transfer
  • Customer sentiment analysis and engagement level
  • Previous interaction history and relationship status
Transfer Modes:
  • Warm Transfer: Agent briefly explains context to human operator before connecting customer
  • Cold Transfer: Direct transfer without agent introduction for faster handoffs
  • Conference: Three-way call with agent, customer, and human operator for complex scenarios
Smart Transfer Routing:
  • Department-specific routing based on conversation content
  • Skill-based routing to most qualified available agent
  • Priority queuing for VIP customers or urgent issues
  • Automatic fallback to voicemail if no agents available

Transfer Prompt Templates

The transfer prompt is crucial - it teaches your AI agent exactly when to transfer calls. Use these professionally crafted multi-language templates:
Se usa para transferir la llamada con una persona en los casos que se indican a continuación:

- El usuario rechaza directamente la propuesta o servicio
- El usuario solicita expresamente hablar con una persona humana
- El usuario muestra desconfianza hacia el asistente virtual
- Se necesita información específica que no está disponible en el sistema
- El usuario requiere autorización o gestión de datos personales sensibles
- Situaciones que requieren negociación o decisiones complejas
- Quejas o reclamaciones que necesitan atención personalizada
- El usuario solicita escalación a un supervisor o gerente
- Casos de facturación complejos o disputas de pagos
- Situaciones médicas o legales que requieren experiencia humana

Webhook Tools

Create powerful API integrations that allow your agent to interact with external systems during conversations through our sophisticated modal interface.
New Feature: Webhook Tools now support advanced parameter mapping, authentication methods, and real-time testing through an intuitive modal interface. You can create custom API integrations that intelligently extract conversation data and trigger external systems.

Webhook Tool Modal Interface

The webhook configuration uses an advanced modal interface with the following sections:
1

Tool Identity Configuration

Configure the basic identity and trigger conditions for your webhook tool.Required Fields:
  • Name: Unique identifier (e.g., “create_lead”, “check_inventory”)
  • Description: Clear explanation of when the AI should use this tool
  • Execution Mode: Choose immediate or deferred execution
2

API Endpoint Configuration

Set up the core API connection details.URL Configuration:
  • Base URL: The complete webhook endpoint URL
  • HTTP Method: GET, POST, PUT, PATCH, or DELETE
  • Request Timeout: 5-60 seconds (default: 20)
3

Authentication Setup

Configure secure authentication for your API endpoints.Authentication Types:
  • Bearer Token authentication
  • API Key authentication
  • Basic Auth with username/password
  • Custom header authentication
4

Parameter Mapping

Define how conversation data maps to API parameters with intelligent extraction.Parameter Types:
  • Query Parameters: URL-encoded parameters for GET requests
  • Body Parameters: JSON payload for POST/PUT/PATCH requests
  • Header Parameters: Custom HTTP headers

Advanced Parameter Configuration

Each webhook parameter supports sophisticated data mapping through our modal interface:
PropertyDescriptionOptionsExample
NameParameter identifierCustom stringcustomer_name
TypeData validationstring, number, boolean, integer, array, objectstring
RequiredMandatory fieldtrue/falsetrue
DescriptionAI understandingNatural language”Customer’s full name from conversation”
Value SourceHow to get valueLLM extraction, static value, conversation metadataLLM prompt
Extraction PromptAI instructionNatural language”Extract the customer’s full name”

Webhook Tool Execution Settings

Configure advanced execution behavior through the modal interface: Execution Control:
  • Immediate: Execute during the active call
  • Deferred: Execute after the call ends
  • Conditional: Execute based on conversation outcome
Agent Behavior Settings:
  • Disable Interruptions: Prevent customer from speaking during execution
  • Force Pre-tool Speech: Require agent announcement before execution
  • Tool Call Sound: Play typing sound during execution (typing/none)
  • Sound Behavior: Auto or manual control of sound effects
Error Handling:
  • Response Timeout: Maximum wait time for API response
  • Retry Logic: Automatic retries on failure
  • Fallback Messages: What to say if API fails
  • Graceful Degradation: Continue conversation without API data

Webhook Integration Examples

Salesforce Lead IntegrationConfigure a webhook tool that automatically creates leads in Salesforce when customers show purchase interest:
{
  "name": "create_salesforce_lead",
  "description": "Create a new lead in Salesforce when customer shows purchase interest",
  "url": "https://api.salesforce.com/services/data/v52.0/sobjects/Lead",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer {{salesforce_token}}",
    "Content-Type": "application/json"
  },
  "body_parameters": {
    "FirstName": {
      "type": "string",
      "required": true,
      "value_type": "llm_prompt",
      "description": "Extract customer's first name from conversation"
    },
    "LastName": {
      "type": "string", 
      "required": true,
      "value_type": "llm_prompt",
      "description": "Extract customer's last name from conversation"
    },
    "Phone": {
      "type": "string",
      "required": true,
      "value_type": "conversation_metadata",
      "description": "Customer's phone number"
    },
    "LeadSource": {
      "type": "string",
      "value_type": "static",
      "static_value": "AI Phone Call"
    }
  }
}

Authentication Configuration

The modal interface supports multiple authentication methods:
JWT/OAuth 2.0 AuthenticationMost modern APIs use Bearer token authentication for security:
{
  "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}
Use Cases:
  • Modern REST APIs (Salesforce, HubSpot, etc.)
  • OAuth 2.0 protected endpoints
  • JWT-based authentication systems
  • Enterprise SaaS platforms

Webhook Testing and Validation

The modal interface includes powerful testing capabilities: Real-time Testing:
  • Test API endpoints directly from the configuration modal
  • Validate authentication credentials before saving
  • Preview request/response data with sample conversation data
  • Debug parameter mapping with live extraction
Validation Features:
  • Automatic URL validation and accessibility checking
  • Parameter type validation with clear error messages
  • Required field validation with helpful suggestions
  • Response format validation for proper integration

End Call Strategy

Configure intelligent call termination with sophisticated answering machine detection and strategic conversation ending.

Enhanced Call Termination Logic

1

Enable Smart Termination

Activate the “End Call Strategy” to handle call endings intelligently.
2

Configure Detection Phrases

Set up multi-language phrases that indicate answering machines or voicemail systems.
3

Define Completion Criteria

Specify what constitutes a successful call that should end naturally.
4

Handle Edge Cases

Configure responses for unexpected scenarios like long silences or system errors.

Advanced Answering Machine Detection

Our enhanced detection system recognizes voicemail and answering machines across multiple languages with expanded phrase detection:
Detection Accuracy: 97%+ accuracy rate in identifying automated systems Languages Supported: Spanish, English, French, German, Italian, Portuguese Response Time: Detection typically occurs within 2-4 seconds of answering False Positive Rate: Less than 2% with enhanced phrase recognition

Expanded End Call Strategy Templates

Configure professional call termination for various scenarios using our comprehensive multi-language templates:
## Finalización de llamada por Detección de Contestador Automático

Si se detecta que el usuario es un contestador automático, finaliza la llamada de inmediato. Aquí tienes ejemplos de mensajes que suelen decir los contestadores automáticos:

**Frases comunes de contestadores:**
- En este momento no podemos atenderle
- Deje su mensaje después de la señal
- El número al que llama...
- Ha llamado al...
- Este es el contestador de...
- Puedes dejar tu mensaje al oir la señal
- Deje su mensaje después de oir la señal
- Gracias por llamar, en estos momentos...
- Por favor, deje su mensaje después del tono
- Lo sentimos, pero en estos momentos...
- Bienvenido al buzón de voz de...
- No podemos atender su llamada ahora mismo
- Por favor, inténtelo de nuevo más tarde
- Ha contactado con el servicio de atención al cliente
- Bienvenido al contestador automático de...
- Su llamada es muy importante para nosotros
- Todos nuestros operadores están ocupados
- Manténgase en línea por favor

## Finalización de Llamada por otros motivos: 

También debes colgar las llamadas cuando:
- El usuario se despida de forma clara
- Te despidas tú mismo
- La conversación haya alcanzado su objetivo completamente
- El usuario indique claramente que no está interesado
- Se detecten largos períodos de silencio (más de 10 segundos)

Email Integration

Configure intelligent email sending capabilities during or after conversations.

Email Configuration

1

Enable Email Integration

Toggle the “Send Email” option to activate email functionality.
2

Configure Email Triggers

Define when the agent should send emails using natural language prompts.
3

Set Email Templates

Configure dynamic subject lines and email body content.
4

Define Recipients

Set up primary recipients and CC options.
Email Trigger Examples:
  • Customer requests detailed product information via email
  • Follow-up emails after successful calls
  • Sending meeting confirmations and calendar invites
  • Quote or proposal delivery after phone conversations
Dynamic Content:
  • Extract customer information from conversation
  • Include call summary and next steps
  • Personalized product recommendations
  • Contact information and appointment details

SMS Integration

Set up intelligent SMS messaging capabilities for follow-up communications.

SMS Configuration

1

Enable SMS Integration

Toggle the “Send SMS” option to activate messaging functionality.
2

Configure SMS Triggers

Define conversation scenarios that should trigger SMS messages.
3

Create Message Templates

Set up dynamic SMS content with conversation data.
4

Test SMS Delivery

Validate SMS functionality with test messages.
SMS Use Cases:
  • Appointment confirmations and reminders
  • Quick follow-up after missed calls
  • Delivery of reference numbers or confirmation codes
  • Links to online resources or booking pages
Best Practices:
  • Keep messages concise and actionable
  • Include clear opt-out instructions
  • Use professional, branded messaging
  • Comply with SMS marketing regulations

Calendar Integration

Configure sophisticated calendar booking with multiple provider support.

Supported Calendar Providers

Google Calendar IntegrationFull integration with Google Calendar for availability checking and appointment booking.Features:
  • Real-time availability checking
  • Automatic event creation
  • Meeting invitations and reminders
  • Timezone handling
  • Conflict detection
Configuration:
  • Calendar ID for availability checking
  • Booking calendar ID for new events
  • Working hours and timezone settings
  • Default meeting duration

Calendar Configuration Options

Availability Settings:
  • Multiple Calendar Support: Check availability across multiple calendars
  • Working Hours: Define business hours for appointment booking
  • Timezone Management: Automatic timezone conversion
  • Buffer Times: Add buffer time between appointments
Booking Preferences:
  • Default Duration: Standard meeting length (15, 30, 60 minutes)
  • Advance Notice: Minimum time required before booking
  • Maximum Advance: How far in advance bookings are allowed
  • Blackout Dates: Exclude specific dates from availability
Meeting Details:
  • Dynamic Titles: Generate meeting titles from conversation context
  • Custom Descriptions: Include call summary and customer details
  • Attendee Management: Automatically add customer email
  • Location Handling: Include meeting location or virtual meeting links

Calendar Integration Workflow

1

Provider Authentication

Set up OAuth 2.0 authentication with Google Calendar or Microsoft Graph API for Outlook integration.
2

Calendar Configuration

Configure primary and secondary calendars, working hours, and availability preferences.
3

Event Templates

Create dynamic event templates with conversation data extraction for title, description, and attendees.
4

Booking Logic

Define availability checking logic, conflict resolution, and automatic scheduling preferences.
Event Data Extraction:
  • Customer name and contact information from conversation
  • Meeting purpose and agenda items discussed
  • Preferred time slots mentioned by customer
  • Special requirements or preparation notes

Recall Protocol

Set up sophisticated automatic callback systems for comprehensive customer follow-up when initial calls don’t achieve their objectives.

Recall System Architecture

Smart Scheduling: Intelligent timing based on customer behavior and business rules Success Detection: Automatic recognition of completed objectives to prevent unnecessary callbacks
Compliance Built-in: Respects Do Not Call lists and regulatory requirements Escalation Paths: Gradually increase intervals and change strategies over time

Recall Configuration

1

Enable Recall System

Activate the recall protocol and set maximum callback attempts.
2

Define Success Conditions

Specify what constitutes a successful call that doesn’t require follow-up.
3

Configure Callback Schedule

Set intelligent timing intervals between recall attempts.
4

Set Escalation Rules

Define how callback strategy changes with each attempt.

Recall Timing Strategies

AttemptTimingUse CaseSuccess Rate
1st Recall15-30 minutesBusy signal, no answer35%
2nd Recall2-4 hoursSame day follow-up25%
3rd RecallNext business dayProfessional follow-up20%
4th Recall3-5 days laterPersistent but respectful15%
5th Recall1-2 weeks laterFinal attempt10%

Success Condition Examples

Objective Achievement:
  • Customer provided required information (contact details, preferences)
  • Meeting or appointment successfully scheduled
  • Purchase decision made (positive or negative with clear finality)
  • Information successfully delivered (pricing, product details, etc.)
Explicit Customer Requests:
  • Customer explicitly requested no further contact
  • Customer scheduled their own callback time
  • Customer was transferred to human agent successfully
  • Customer asked to be contacted via different method (email, text)
Call Completion Scenarios:
  • Full conversation completed with all questions answered
  • Customer showed clear lack of interest with polite decline
  • Answering machine message successfully delivered
  • Technical issues prevented meaningful conversation

Recall Configuration Options

Timing Controls:
  • Business Hours Only: Restrict callbacks to business hours
  • Time Zone Awareness: Respect customer’s local time zone
  • Day-of-Week Preferences: Avoid weekends or specific days
  • Holiday Exclusions: Skip holidays and blackout dates
Escalation Strategy:
  • Message Variation: Change script or approach with each attempt
  • Channel Switching: Transition to email or SMS after failed calls
  • Human Handoff: Transfer persistent cases to human agents
  • Compliance Monitoring: Automatic DNC list checking
Performance Tracking:
  • Success Rate Analytics: Track effectiveness by attempt number
  • Optimal Timing Analysis: Identify best callback windows
  • Customer Response Patterns: Learn from customer behavior
  • ROI Measurement: Calculate cost-effectiveness of recalls

Caller ID Management

Set up professional caller IDs for outbound calls to improve answer rates and brand recognition.

Caller ID Configuration

1

Add Phone Numbers

Register your business phone numbers for use as caller IDs through the modal interface.
2

Verify Ownership

Complete verification process via SMS or voice call verification.
3

Set Default Caller ID

Choose which number appears for outbound calls by default.
4

Monitor Performance

Track answer rates by caller ID to optimize selection.

Caller ID Best Practices

Number Selection:
  • Use local area codes when possible (increases answer rates by 20-30%)
  • Choose memorable, professional-looking numbers
  • Avoid numbers that look like spam (avoid 555, repeated digits)
  • Use toll-free numbers for national campaigns
Verification Process:
  • SMS verification for mobile numbers
  • Voice verification for landlines
  • Business documentation for toll-free numbers
  • Compliance with carrier requirements
Performance Optimization:
  • A/B test different caller IDs
  • Monitor answer rates by time of day
  • Adjust caller ID based on campaign type
  • Use different numbers for different business units

Multi-Account Caller ID Management

Twilio Subaccount Integration:
  • Manage caller IDs across multiple Twilio subaccounts
  • Automatic synchronization of verified numbers
  • Centralized caller ID performance analytics
  • Cross-account number pooling for better coverage
Phone Number Assignment:
  • Assign specific numbers to specific agents or campaigns
  • Automatic rotation for high-volume calling
  • Geographic number matching for local presence
  • Industry-specific number selection (healthcare, finance, etc.)

Advanced Modal Interfaces

Our Actions & Tools section features sophisticated modal interfaces for complex configurations:

Webhook Tool Modal

Multi-step Configuration:
  1. Tool Identity: Name, description, and execution settings
  2. API Configuration: URL, method, authentication
  3. Parameter Mapping: Query params, body params, headers
  4. Testing & Validation: Real-time API testing
Advanced Features:
  • Syntax Highlighting: JSON and code syntax highlighting
  • Auto-completion: Intelligent parameter suggestions
  • Validation: Real-time error checking and validation
  • Templates: Pre-built configurations for common integrations

Calendar Integration Modal

Provider-specific Configuration:
  • Google Calendar: OAuth setup, calendar selection
  • Outlook Calendar: Exchange configuration, authentication
  • Custom Settings: Working hours, timezones, buffer times
Event Template Configuration:
  • Dynamic Titles: Smart title generation from conversation context
  • Attendee Management: Automatic customer information extraction
  • Meeting Preferences: Duration, location, reminder settings
  • Conflict Resolution: Automatic rescheduling and alternative time suggestions

Recall Protocol Modal

Comprehensive Recall Setup:
  • Success Criteria Configuration: Define when callbacks are unnecessary
  • Timing Strategy: Configure sophisticated scheduling algorithms
  • Escalation Rules: Progressive strategy changes with each attempt
  • Compliance Management: Built-in DNC and regulatory compliance

Template Library

Instant Configuration:
  • Pre-built templates for common use cases
  • Multi-language support for international deployments
  • Industry-specific configurations
  • Best practice examples with explanations

Troubleshooting Common Issues

Failed Transfers:
  • Check phone number format (use international format)
  • Verify SIP URI syntax and network connectivity
  • Test transfer destinations manually
  • Review carrier compatibility and routing
Context Loss:
  • Ensure transfer prompts include context instructions
  • Verify human agent training on receiving transferred calls
  • Check integration between systems
  • Review call logging and recording setup

Best Practices

Call Transfer Optimization

  1. Clear Trigger Definition
    • Use multi-language templates for precise trigger conditions
    • Define specific, unambiguous scenarios for transfers
    • Include escalation paths for different types of issues
    • Test transfer logic across different customer personas
  2. Context Preservation
    • Configure comprehensive call context transfer
    • Include customer information, conversation summary, and specific needs
    • Provide clear reason for transfer to minimize customer frustration
    • Train human agents on receiving AI-transferred calls

Webhook Development

  1. Modal-driven Configuration
    • Leverage the sophisticated modal interface for complex setups
    • Use template library for validated starting configurations
    • Test API endpoints directly within the interface
    • Validate parameter mappings with real conversation data
  2. Security Implementation
    • Always use HTTPS endpoints
    • Configure proper authentication through secure header management
    • Validate and sanitize all incoming data
    • Use rate limiting to prevent abuse

Calendar Integration Optimization

  1. Multi-Provider Strategy
    • Support both Google Calendar and Outlook for maximum compatibility
    • Configure fallback providers for high availability
    • Implement cross-platform availability checking
    • Maintain consistent booking experience across providers
  2. Smart Scheduling
    • Use intelligent availability detection with buffer times
    • Implement automatic conflict resolution and rescheduling
    • Configure timezone-aware booking for global customers
    • Set up automated reminder and confirmation systems

Recall Protocol Management

  1. Strategic Planning
    • Define clear success criteria to prevent unnecessary callbacks
    • Implement progressive escalation with varied approaches
    • Respect customer preferences and compliance requirements
    • Monitor and optimize based on performance analytics
  2. Performance Optimization
    • Analyze recall effectiveness by timing and strategy
    • A/B test different callback intervals and approaches
    • Use customer behavior data to optimize scheduling
    • Implement intelligent DNC management and compliance

Advanced Integration

  1. Multi-tool Workflows
    • Combine webhook tools with calendar integration
    • Chain email and SMS follow-ups after calls
    • Use transfer capabilities as escalation paths
    • Implement comprehensive callback strategies
  2. Performance Monitoring
    • Track webhook success rates and response times
    • Monitor caller ID performance by campaign
    • Analyze transfer success and customer satisfaction
    • Optimize based on actual usage data and customer feedback
Compliance Requirements: All integrations must comply with applicable regulations including TCPA (US), GDPR (EU), and industry-specific requirements. Always include proper consent mechanisms and opt-out procedures.

Next Steps

After configuring your Actions & Tools, you can further enhance your agent with:
  • Input Parameters: Set up dynamic variables for personalized conversations
  • Output Settings: Configure data extraction and webhook delivery
  • Evaluations: Define success metrics and conversation quality measures
  • Knowledge Base: Add contextual information to improve agent responses