跳转到主要内容

消息

聊天​

命令chats.aspx
方法GET
响应

成功 → 包含用户可见的最新聊天列表：

[
    {
        "jid": "5511987654321@s.whatsapp.net",
        "name": "",
        "spam": false,
        "count": 0,
        "mute": "",
        "t": 1602182138,
        "archive": false,
        "modify_tag": "761618",
        "picture": "",
        "Lastupdate": "0001-01-01T02:00:00Z"
    },
    ...

错误 → 返回 empty

发送消息​

命令send_message.aspx
方法POST
主体
{ 
    "number": "5511987654321@s.whatsapp.net", 
    "message": "Hello"
}

文本格式化

效果描述示例
粗体星号之间的文本*Bold*
删除线两个波浪号字符之间的文本~Strikethrough~
斜体两个下划线字符之间的文本_Italic_
等宽字体等宽格式的文本```Monospace```
新
行		要换行请使用字符 \nNew\nline
响应
{
    {
        "success": true,
        "message": {
            "Id": "61C14232F8748A08677DF4775ECBBE33" 
        }
    }
}

Id 唯一消息 ID

发送图片​

命令send_message_file.aspx
方法POST
主体

从 URL​

{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "Image Description",
    "url": "https://images.pexels.com/photos/4627455/pexels-photo-4627455.jpeg",
    "type": "image/jpeg",
    "filename": "" // 可选
}

以 base64 格式​

{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "Image Description",
    "mimetype": "image/jpeg",
    "base64": "JVBERi0xLjYNJeLjz9MNCjM3IDAgb2JqIDw8L..." // 转换为 base64 的原始文件内容
}
响应
{
    "success": true,
    "message": {
        "MessageID": "6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "Url": "https://api.witi.me/static/6D6307C3-2973-4468-85FA-D047CB8E1F2B/media/6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "jpegThumbnail": ""
    }
}

错误：

{
    "success": false,
    "message": null
}

发送文件​

命令send_message_file.aspx
方法POST
主体

从 URL​

{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "Document Description",
    "url": "https://filesamples.com/samples/document/txt/sample1.txt",
    "type": "file",
}

以 base64 格式​

{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "Document Description",
    "mimetype": "text/plain",
    "base64": "JVBERi0xLjYNJeLjz9MNCjM3IDAgb2JqIDw8L..." // 转换为 base64 的原始文件内容
}
响应
{
    "success": true,
    "message": {
        "MessageID": "6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "Url": "https://api.witi.me/static/6D6307C3-2973-4468-85FA-D047CB8E1F2B/media/6AFCFEAB7FC3ECA3753F1C8AB86ADF15",
        "jpegThumbnail": ""
    }
}

发送音频​

命令send_message_file.aspx
方法POST
主体
{ 
    "number": "5511987654321@s.whatsapp.net", 
    "caption": "audio.wav",
    "type": "audio",
    "mimetype": "audio/wav",
    "base64": "GkXfo59ChoEBQveBAULy...",
}
警告

音频文件必须是 wav 格式

发送联系人​

使用 vcard 格式发送联系人消息。

命令send_contact.aspx
方法POST
主体
{ 
    "jid": "5511987654321@s.whatsapp.net", 
    "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;Fulano da Silva;;\nFN:Fulano da Silva\nitem1.TEL;waid=5511987654321@s.whatsapp.net:+5511987654321@s.whatsapp.net\nitem1.X-ABLabel:Mobile\nEND:VCARD"    
}
结果
{
    "success": true,
    "message": {
        "Id": "3EB06E1CAC62CAEB8219"
    }
}

订阅​

表示与联系人开始对话。

命令subscribe.aspx
方法POST
主体
{ 
    "number": "5511987654321@s.whatsapp.net",
}
结果
{
    "success": true
}

发送状态​

命令send_presence.aspx
方法POST
主体
{ 
    "jid": "5511987654321@s.whatsapp.net", 
    "status": "composing", // composing | available | unavailable | recording
}
警告

要向联系人发送状态命令，必须首先发送 subscribe.aspx 命令。

信息

为了让联系人接收事件，WhatsApp 有时要求双方之间先交换消息。

结果
{
    "success": true
}

标记为已读​

将收到的消息标记为已读，以便联系人收到此信息。

命令mark_read.aspx
方法POST
主体
{ 
    "jid": "5511987654321@s.whatsapp.net", 
    "messageid": "0272351687E8BA60700B8C6C400E05A6"
}
结果
{
    "success": true
}