Table of Contents

Introduction

Welcome to the Wazaio API documentation! Our APIs allow you to seamlessly integrate Wazaio’s powerful WhatsApp contact center features into your own applications. This documentation will guide you through the available API endpoints and demonstrate how to use them effectively.

API Endpoints

1. Send Message

POST
{{apiBaseUrl}}/{{vendorUid}}/contact/send-message

Send Message

AUTHORIZATION
Bearer Token
Token

{{bearerToken}}

				
					{
    // optional from phone number id is not given it will use default phone number id
    "from_phone_number_id": "{{fromPhoneNumberId}}",
    "phone_number": "{{phoneNumber}}",
    "message_body": "your message body",
    // if you want to create contact if it does not exist
    "contact": {
        "first_name" : "Johan",
        "last_name" : "Doe",
        "email" : "johndoe@doamin.com",
        "country" : "india",
        "language_code" : "en",
        "groups" : "examplegroup1,examplegroup2"

    }
}
				
			

Example request

				
					curl --location -g '{{apiBaseUrl}}/{{vendorUid}}/contact/send-message' \
--data-raw '{
    // optional from phone number id is not given it will use default phone number id
    "from_phone_number_id": "{{fromPhoneNumberId}}",
    "phone_number": "{{phoneNumber}}",
    "message_body": "your message body",
    // if you want to create contact if it does not exist
    "contact": {
        "first_name" : "Johan",
        "last_name" : "Doe",
        "email" : "johndoe@doamin.com",
        "country" : "india",
        "language_code" : "en",
        "groups" : "examplegroup1,examplegroup2"

    }
}'
				
			

2. Send Media Message

POST
{{apiBaseUrl}}/{{vendorUid}}/contact/send-media-message

 

AUTHORIZATION
Bearer Token
 
Token

{{bearerToken}}

				
					{
    // optional from phone number id is not given it will use default phone number id
    "from_phone_number_id": "{{fromPhoneNumberId}}",
    "phone_number" : "{{phoneNumber}}",
    "media_type" : "document",
    "media_url" : "https://images.pexels.com/photos/276267/pexels-photo-276267.jpeg?auto=compress&cs=tinysrgb&w=1260&h=750&dpr=2",
    "caption" : "your capation for image or video media types",
    "file_name" : "your file name for document",
    // if you want to create contact if it does not exist
    "contact": {
        "first_name" : "Johan",
        "last_name" : "Doe",
        "email" : "johndoe@doamin.com",
        "country" : "india",
        "language_code" : "en",
        "groups" : "examplegroup1,examplegroup2"
    }
}
				
			

Example request

				
					curl --location -g '{{apiBaseUrl}}/{{vendorUid}}/contact/send-media-message' \
--data-raw '{
    // optional from phone number id is not given it will use default phone number id
    "from_phone_number_id": "{{fromPhoneNumberId}}",
    "phone_number" : "{{phoneNumber}}",
    "media_type" : "document",
    "media_url" : "https://images.pexels.com/photos/276267/pexels-photo-276267.jpeg?auto=compress&cs=tinysrgb&w=1260&h=750&dpr=2",
    "caption" : "your capation for image or video media types",
    "file_name" : "your file name for document",
    // if you want to create contact if it does not exist
    "contact": {
        "first_name" : "Johan",
        "last_name" : "Doe",
        "email" : "johndoe@doamin.com",
        "country" : "india",
        "language_code" : "en",
        "groups" : "examplegroup1,examplegroup2"
    }
}'
				
			

3. Send Template Message

POST
{{apiBaseUrl}}/{{vendorUid}}/contact/send-template-message

 

AUTHORIZATION
Bearer Token
 
Token

{{bearerToken}}

				
					{
    // optional from phone number id is not given it will use default phone number id
    "from_phone_number_id": "{{fromPhoneNumberId}}",
    "phone_number": "{{phoneNumber}}",
    "template_name" : "your_template_name",
    "template_language" : "en",
    "header_image" : "https://cdn.pixabay.com/photo/2015/01/07/15/51/woman-591576_1280.jpg",
    "header_video" : "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4",
    "header_document" : "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4",
    "header_document_name" : "{full_name}",
    "header_field_1" : "{full_name}",
    "location_latitude" : "22.22",
    "location_longitude" : "22.22",
    "location_name" : "{first_name}",
    "location_address" : "{country}",
    "field_1" : "{Age}",
    "field_2" : "{full_name}",
    "field_3" : "{first_name}",
    "field_4" : "{last_name}",
    "button_0" : "{email}",
    "button_1" : "{phone_number}",
    "copy_code" : "YourCode",
    // if you want to create contact if it does not exist
    "contact": {
        "first_name" : "Johan",
        "last_name" : "Doe",
        "email" : "johndoe@doamin.com",
        "country" : "india",
        "language_code" : "en",
        "groups" : "examplegroup1,examplegroup2"
    }
}
				
			

Example request

				
					curl --location -g '{{apiBaseUrl}}/{{vendorUid}}/contact/send-template-message' \
--data-raw '{
    // optional from phone number id is not given it will use default phone number id
    "from_phone_number_id": "{{fromPhoneNumberId}}",
    "phone_number": "{{phoneNumber}}",
    "template_name" : "your_template_name",
    "template_language" : "en",
    "header_image" : "https://cdn.pixabay.com/photo/2015/01/07/15/51/woman-591576_1280.jpg",
    "header_video" : "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4",
    "header_document" : "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4",
    "header_document_name" : "{full_name}",
    "header_field_1" : "{full_name}",
    "location_latitude" : "22.22",
    "location_longitude" : "22.22",
    "location_name" : "{first_name}",
    "location_address" : "{country}",
    "field_1" : "{Age}",
    "field_2" : "{full_name}",
    "field_3" : "{first_name}",
    "field_4" : "{last_name}",
    "button_0" : "{email}",
    "button_1" : "{phone_number}",
    "copy_code" : "YourCode",
    // if you want to create contact if it does not exist
    "contact": {
        "first_name" : "Johan",
        "last_name" : "Doe",
        "email" : "johndoe@doamin.com",
        "country" : "india",
        "language_code" : "en",
        "groups" : "examplegroup1,examplegroup2"
    }
}'
				
			

4. Create New Contact

POST
{{apiBaseUrl}}/{{vendorUid}}/contact/create

 

AUTHORIZATION
Bearer Token
 
Token

{{bearerToken}}

				
					{
    "phone_number" : "{{phoneNumber}}",
    "first_name" : "Johan",
    "last_name" : "Doe",
    "email" : "johndoe@doamin.com",
    "country" : "india",
    "language_code" : "en",
    "groups" : "examplegroup1,examplegroup2"
}
				
			

Example request

				
					curl --location -g '{{apiBaseUrl}}/{{vendorUid}}/contact/create' \
--data-raw '{
    "phone_number" : "{{phoneNumber}}",
    "first_name" : "Johan",
    "last_name" : "Doe",
    "email" : "johndoe@doamin.com",
    "country" : "india",
    "language_code" : "en",
    "groups" : "examplegroup1,examplegroup2"
}'
				
			

By integrating Wazaio’s API endpoints, you can efficiently manage your WhatsApp communications, automate messaging workflows, and enhance customer engagement. For more detailed information on each API endpoint, refer to the individual sections above.