1a. Explanation of Python Code Step

Sample Python Code

import requests

api_key = # 'input your API key here'

url = 'https://app.maax.ai/api/v2/outgoing-messages/'
headers = {
    '2hd-api-key': api_key

service_type = # 'customer_support_automation' or 'sales_automation' 
platform = # 'email, 'website, or 'sms'
ai_id = # 'input your ai id here'
followup_url = # 'input your followup webhook url here'
send_response_url = # 'input your followup webhook url here'

message_content = input_data['message']
phone_number = input_data.get('phone', '') 
first_name = input_data.get('first_name', 'unknown')

data = {
    'service_type': service_type,
    'platform': platform,
    'ai_id': ai_id,
    'followup_url': followup_url,
    'send_response_url': send_response_url,
    'message_content': message_content,
    'prospect_info': {
        'phone': phone_number,
        'first_name': first_name

# POST request
    response = requests.post(url, json=data, headers=headers)
    output = [response.json()]

except requests.exceptions.RequestException as e:
    error_message = str(e)
    output = {"error": error_message}


  1. Simplifying the Code Step Despite its technical appearance, the code step in Zapier has been simplified to mainly involve copy-pasting and filling in different values.

  2. Utilizing 'Code by Zapier' Step This step is used after everything in the 'ingest' part of the process. It involves running Python code.

  3. Guidance on Usage The speaker encourages pausing and revisiting sections of the tutorial as needed, emphasizing the ease of the process.

  4. Mapping Input Data The tutorial focuses on mapping specific fields like message, phone, and first name in the input data to the code.

  5. Extracting User Query Information The 'message' field involves dropping in the user's question, which will be sent to Maax AI for processing.

  6. Additional Data Fields Other data fields like phone and first name are also sent over. The user has the option to add more information like email and Instagram based on their needs.

  7. API Key Handling The API key is discussed, with a recommendation to use 'storage by Zap' in Zapier for better security, instead of directly showing API keys.

  8. Setting up Sales Automation and AI ID The user selects their sales automation platform and inputs the AI ID from their dashboard, which links the specific version of AI to the Zapier step.

  9. Establishing Personalized Responses Different AI IDs may represent different use cases, each driving a unique goal, thus establishing different 'personalities' for the responses.

  10. Setting Up Follow-Up URLs The tutorial includes mapping webhooks from Zapier in the body response, which is crucial for sending responses to Zapier triggers.

  11. Finalizing the Step and Testing After setting up, a test is run to ensure that the output is successful and that the data is correctly sent to Maax AI.

Last updated