Skip to main content

Contacts

Contact List​

Commandcontacts.aspx
MethodGET
Response

List of contacts

    [
        {
            "jid": "5511987654321@s.whatsapp.net",
            "notify": "Maria",
            "verify": "",
            "vname": "",
            "short": "",
            "name": "",
            "picture": "https://api.witi.me/get_picture.aspx?WID=6D6307C3-2973-4468-85FA-D047CB8E1F2E&jid=5511987654321@s.whatsapp.net",
            "Lastupdate": "2021-02-09T19:47:35.4294153Z",
            "LastMessageTime": 0,
            "biz": false,
            "status": 200,
            "tag": "",
            "Count": 0,
            "Mute": false,
            "Spam": false,
            "Archive": true,
            "isGroup": false
        },
        ...
    ]

Individual Contact​

Returns the profile if it exists in the WhatsApp contact list on the device.

Commandget_profile.aspx
MethodPOST
Body
{ 
    "number" : "5511987654321@s.whatsapp.net" 
}
Response

SUCCESS → Returned profile:

 {
    "sucesso": true,
    "mensagem": {
        "jid": "5511987654321@s.whatsapp.net",
        "notify": "Maria Aparecida",
        "short": "Maria",
        "name": "Maria",
        "picture": "https://api.witi.me/static/6D6307C3-2973-4468-85FA-D047CB8E1F2E/profile/5511987654321.jpeg?h=637485519829710708",
        "Lastupdate": "2021-02-10T11:06:22.736058-03:00",
        "LastMessageTime": 0,
        "biz": false,
        "status": 200,
        "tag": null,
        "Count": 0,
        "Mute": false,
        "Spam": false,
        "Archive": false,
        "isGroup": false
    }
}

ERROR:

{
    "sucesso": false,
    "mensagem": null
}

Validate Contact​

Validates if the contact is a valid WhatsApp profile (without needing to be an added contact).

Commandquery_profile.aspx
MethodPOST
Body
{ 
    "number" : "5511987654321@s.whatsapp.net" 
}
Response

SUCCESS → Returned profile:

 {
    "sucesso": true,
    "mensagem": {
        "jid": "5511987654321@s.whatsapp.net",
        "notify": "Maria Aparecida",
        "short": "Maria",
        "name": "Maria",
        "picture": "https://api.witi.me/static/6D6307C3-2973-4468-85FA-D047CB8E1F2E/profile/5511987654321.jpeg?h=637485519829710708",
        "Lastupdate": "2021-02-10T11:06:22.736058-03:00",
        "LastMessageTime": 0,
        "biz": false,
        "status": 200,
        "tag": null,
        "Count": 0,
        "Mute": false,
        "Spam": false,
        "Archive": false,
        "isGroup": false
    }
}

ERROR:

{
    "sucesso": false,
    "mensagem": null
}

Archive Contact​

Commandset_jidstatus.aspx
MethodPOST
Body
{ 
    "jid" : "5511987654321@s.whatsapp.net", 
    "status": 1,                                        // 1 = archive | 0 = unarchive
    "messageId": "FC47BC67B05BD3972E6A6F7EF824BE15",    // ID da última mensagem do contato
    "ownerMessage": "true"                              // true se a última mensagem foi enviada por mim | false
}
Response
{
    "resultado": true
}

Profile Picture​

Commandget_picture.aspx
MethodGET
Parameters

jid - Contact's JID

Response

SUCCESS → Profile picture as registered on WhatsApp

ERROR → Generic image:

Messages​

Commandget_messages.aspx
MethodPOST
Body
{ 
    "jid": "5511987654321@s.whatsapp.net",
    "count": "10",       // number of messages to return
    "messageId": "",     // if provided, returns messages prior to this ID
    "fromme": ""         // true | false - Only messages sent by me
}
Response

SUCESSO → Message list:

{
    "sucesso": true,
    "mensagem": [
        "{\"Type\":\"receveid_message\",\"Body\":{\"Info\": {\"Id\":\"7C4673A32A34A6D4C07D2035BC114FC1\", \"RemoteJid\":\"5511987654321@s.whatsapp.net\",\"SenderJid\":\"\",\"FromMe\": true,\"Timestamp\": 1612892924,\"messageTimestampTiks\": 637484789240000000,\"Status\": 4,\"QuotedMessageID\":\"\",\"Source\": {\"key\":{\"remoteJid\":\"5511987654321@s.whatsapp.net\",\"fromMe\":true,\"id\":\"7C4673A32A34A6D4C07D2035BC114FC1\"},\"message\":{\"conversation\": \"Bom-dia!\"},\"messageTimestamp\": 1612892924,\"status\": 2,\"participant\":\"5511987654321@s.whatsapp.net\"}},\"Text\": \"Bom-dia!\"}}",
        ...
    ]
}

ERROR:

{
    "sucesso": false
}