Whatsapp Fetch Conversation

On this page

Request

Curl Example

                            
                            curl --location 'https://api.motict.com/v1/wa/unmasking/conversations/{wa_id}/messages/{conversation_wa_id}?start=start_date&end=end_date&type=conversation_type' \
                            --header 'Authorization: api_key'

Parameters

Name	Type	Required	Description
api_key	String	Yes	API key credential will be provided by Motict team.
wa_id	String	Yes	Your Whatsapp business phone number. Phone numbers are in E.164 format (e.g., 6285123456790)
conversation_wa_id	String	Yes	Target phone number or group id. Phone numbers are in E.164 format (e.g., 6285123456790)
start	String	Yes
end	String	Yes
type	String	Yes	Type of conversation

Response

The response contains JSON body with message status whether the request is success or error. And also the message id that has been sent to the user.

Body

                            
                                {
                                    "message": "success",
                                    "data": {
                                        "wa_id": "+628123456789",
                                        "conversation_wa_id": "+628987654321",
                                        "conversation_type": "individual",
                                        "start_at": "2024-06-23",
                                        "end_at": "2024-06-23",
                                        "conversations": [
                                            {
                                                "type": "inbound",
                                                "message_type": "image",
                                                "image": {
                                                    "link": "https://motict.com/1719130691.jpeg",
                                                    "caption": "Inbound"
                                                },
                                                "timestamp": "2024-06-23T08:18:11Z"
                                            },
                                            {
                                                "type": "inbound",
                                                "message_type": "text",
                                                "text": {
                                                    "body": "hai"
                                                },
                                                "timestamp": "2024-06-23T08:20:32Z"
                                            }
                                        ]
                                    }
                                }

Parameters

Name	Type	Description
id	String	Whatsaap Message ID will be used as call identifier for each request
message	String	Success or error message. For error response, check Error section for mor details
data.wa_id	String	The WhatsApp Number
data.conversation_wa_id	String	Conversation WhatsApp Number
data.conversation_type	String	The conversation type. (individual/group)
data.start_at	String	Start date get conversation
data.end_at	String	End date get conversation
conversations	Array
conversation.type	String	Type of conversation type each message. (inbound/outbound)
conversation.message_type	String	Type of chat. (text/image)
conversation.text.body	String	message
conversation.image.link	String	URL image location
conversation.image.caption	String	Caption on image
conversation.timestamp	String	Date time of message