मुख्य सामग्री पर जाएं

​
Groups

Wappfy API के माध्यम से WhatsApp groups manage करें। आप groups बना सकते हैं, participants manage कर सकते हैं, invite links handle कर सकते हैं, और बहुत कुछ कर सकते हैं। सभी group endpoints एक specific instance से जुड़े हैं: 
/api/instances/{instanceId}/groups/...

​
एक Group बनाएं

प्रारंभिक participants के साथ एक नया WhatsApp group बनाएं। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project Alpha",
    "participants": [
      "[email protected]",
      "[email protected]"
    ]
  }'
Response: 
{
  "data": {
    "group_id": "[email protected]",
    "name": "Project Alpha",
    "participants": [
      {
        "id": "[email protected]",
        "is_admin": false
      },
      {
        "id": "[email protected]",
        "is_admin": false
      }
    ]
  }
}

​
Groups की सूची

Instance जिन सभी groups का member है उन्हें प्राप्त करें। 
curl https://api.wappfy.io/api/instances/inst_abc123/groups \
  -H "X-Api-Key: YOUR_API_KEY"
Response: 
{
  "data": [
    {
      "group_id": "[email protected]",
      "name": "Project Alpha",
      "participant_count": 5
    },
    {
      "group_id": "[email protected]",
      "name": "Support Team",
      "participant_count": 12
    }
  ]
}

​
Group की जानकारी प्राप्त करें

किसी specific group की विस्तृत जानकारी fetch करें। 
curl https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected] \
  -H "X-Api-Key: YOUR_API_KEY"
Response: 
{
  "data": {
    "group_id": "[email protected]",
    "name": "Project Alpha",
    "description": "Team workspace for Project Alpha",
    "owner": "[email protected]",
    "created_at": "2026-01-15T10:00:00Z",
    "participants": [
      {
        "id": "[email protected]",
        "is_admin": true,
        "is_super_admin": true
      },
      {
        "id": "[email protected]",
        "is_admin": false,
        "is_super_admin": false
      }
    ]
  }
}

​
एक Group Update करें

Group का name या description update करें। यह action करने के लिए आपका group admin होना आवश्यक है। 
curl -X PATCH https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected] \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project Alpha v2",
    "description": "Updated workspace for Project Alpha"
  }'
केवल group admins ही group name और description update कर सकते हैं। यदि instance admin नहीं है, तो यह 403 error लौटाएगा।

​
एक Group छोड़ें

Instance को group से हटाएं। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected]/leave \
  -H "X-Api-Key: YOUR_API_KEY"
Group छोड़ने के बाद, आपको वापस जोड़ने के लिए invite link या किसी अन्य admin की आवश्यकता होगी।

​
Participants

​
Participants की सूची

किसी group के सभी participants प्राप्त करें। 
curl https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected]/participants \
  -H "X-Api-Key: YOUR_API_KEY"
Response: 
{
  "data": [
    {
      "id": "[email protected]",
      "is_admin": true,
      "is_super_admin": true
    },
    {
      "id": "[email protected]",
      "is_admin": false,
      "is_super_admin": false
    },
    {
      "id": "[email protected]",
      "is_admin": true,
      "is_super_admin": false
    }
  ]
}

​
Participants जोड़ें

Group में एक या अधिक participants जोड़ें। आपका group admin होना आवश्यक है। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected]/participants \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      "[email protected]",
      "[email protected]"
    ]
  }'

​
Participants हटाएं

Group से एक या अधिक participants हटाएं। आपका group admin होना आवश्यक है। 
curl -X DELETE https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected]/participants \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      "[email protected]"
    ]
  }'

​
Invite Codes

​
Invite Code प्राप्त करें

Group का invite link generate या प्राप्त करें। आपका group admin होना आवश्यक है। 
curl https://api.wappfy.io/api/instances/inst_abc123/groups/[email protected]/invite-code \
  -H "X-Api-Key: YOUR_API_KEY"
Response: 
{
  "data": {
    "invite_code": "https://chat.whatsapp.com/AbCdEfGhIjKlMn"
  }
}

​
Invite Code से Join करें

Invite code का उपयोग करके group में शामिल हों। 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/groups/join \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "invite_code": "AbCdEfGhIjKlMn"
  }'
केवल code भाग pass करें, पूर्ण URL नहीं। https://chat.whatsapp.com/AbCdEfGhIjKlMn के लिए, AbCdEfGhIjKlMn pass करें।

​
Groups में Messages भेजना

किसी group में message भेजने के लिए, group की chat ID के साथ standard message भेजें endpoint का उपयोग करें: 
curl -X POST https://api.wappfy.io/api/instances/inst_abc123/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "[email protected]",
    "type": "text",
    "text": "Hello team!"
  }'
Group chat IDs हमेशा @g.us से समाप्त होती हैं।

​
Endpoint Reference

MethodEndpointविवरण
POST/api/instances/{id}/groupsनया group बनाएं
GET/api/instances/{id}/groupsसभी groups की सूची
GET/api/instances/{id}/groups/{groupId}Group की जानकारी प्राप्त करें
PATCH/api/instances/{id}/groups/{groupId}Group name/description update करें
POST/api/instances/{id}/groups/{groupId}/leaveGroup छोड़ें
GET/api/instances/{id}/groups/{groupId}/participantsParticipants की सूची
POST/api/instances/{id}/groups/{groupId}/participantsParticipants जोड़ें
DELETE/api/instances/{id}/groups/{groupId}/participantsParticipants हटाएं
GET/api/instances/{id}/groups/{groupId}/invite-codeInvite code प्राप्त करें
POST/api/instances/{id}/groups/joinInvite code से join करें

​
Error Handling

Status Codeविवरण
403आप इस group के admin नहीं हैं।
404Group नहीं मिला या instance member नहीं है।
409Participant पहले से group में है (add पर) या group में नहीं है (remove पर)।
422अमान्य participant format। {phone}@s.whatsapp.net का उपयोग करें।