curl --request POST \
--url https://api.wppfy.com/group/create \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"name": "Meu Novo Grupo",
"participants": [
"5521987905995"
]
}
'{
"group": {
"JID": "jid8@g.us",
"OwnerJID": "1232@s.whatsapp.net",
"OwnerPN": "<string>",
"Name": "Grupo de Soporte",
"NameSetAt": "2023-11-07T05:31:56Z",
"NameSetBy": "<string>",
"NameSetByPN": "<string>",
"Topic": "<string>",
"TopicID": "<string>",
"TopicSetAt": "2023-11-07T05:31:56Z",
"TopicSetBy": "<string>",
"TopicSetByPN": "<string>",
"TopicDeleted": true,
"IsLocked": true,
"IsAnnounce": true,
"AnnounceVersionID": "<string>",
"IsEphemeral": true,
"DisappearingTimer": 1,
"IsIncognito": true,
"IsParent": true,
"IsJoinApprovalRequired": true,
"LinkedParentJID": "<string>",
"IsDefaultSubGroup": true,
"DefaultMembershipApprovalMode": "<string>",
"GroupCreated": "2023-11-07T05:31:56Z",
"CreatorCountryCode": "<string>",
"ParticipantVersionID": "<string>",
"Participants": [
{
"JID": "<string>",
"LID": "<string>",
"PhoneNumber": "<string>",
"IsAdmin": true,
"IsSuperAdmin": true,
"DisplayName": "<string>",
"ImagePreview": "<string>",
"Error": 1,
"AddRequest": {
"Code": "<string>",
"Expiration": "2023-11-07T05:31:56Z"
},
"Username": "<string>"
}
],
"MemberAddMode": "",
"AddressingMode": "",
"OwnerCanSendMessage": true,
"OwnerIsAdmin": true,
"DefaultSubGroupId": "<string>",
"invite_link": "<string>",
"request_participants": "<string>",
"image_url": "<string>",
"image_preview_url": "<string>",
"picture_id": "<string>",
"picture_preview_id": "<string>",
"picture_empty_at": "2023-11-07T05:31:56Z",
"image_checked_at": "2023-11-07T05:31:56Z",
"image_preview_checked_at": "2023-11-07T05:31:56Z",
"parent_community": {
"jid": "<string>",
"name": "<string>",
"image_url": "<string>",
"image_preview_url": "<string>",
"default_subgroup_jid": "<string>"
},
"participant_profiles": [
{
"jid": "<string>",
"pn": "<string>",
"lid": "<string>",
"username": "<string>",
"display_name": "<string>",
"name": "<string>",
"image_url": "<string>",
"image_preview_url": "<string>",
"picture_id": "<string>",
"picture_preview_id": "<string>",
"is_admin": true,
"is_super_admin": true
}
],
"ParticipantCount": 1,
"request_participants_lid": "<string>"
},
"failed": [
"<string>"
]
}{
"error": "no valid WhatsApp participants",
"failed": [
"<string>"
]
}{
"error": "Error al crear el grupo"
}Crear un nuevo grupo
Crea un grupo con participantes iniciales opcionales. WhatsApp incluye al creador automáticamente.
Envíe participants: [], omita el campo o use null para crear un grupo solo con el creador. Informar solo el propio PN/LID tiene el mismo efecto; no es necesario agregar al creador manualmente.
Para agregar a otras personas, informe números con código de país (solo dígitos) o JIDs PN completos, como 5511999999999@s.whatsapp.net. También se aceptan JIDs LID conocidos por la instancia. Los participantes se verifican y se eliminan los duplicados/alias del creador. Una lista con invitados inválidos y ningún invitado válido sigue devolviendo 400; no se convierte silenciosamente en un grupo vacío.
La respuesta contiene group y failed. Quienes no pudieron entrar por su configuración de privacidad quedan en failed, sin el código de la invitación individual: para invitarlos, llame a POST /group/updateParticipants con action: add (vea Convidar pessoas). Después de la creación, el administrador puede obtener la invitación en GET /group/invitelink/{groupJID}, usando group.JID.
curl --request POST \
--url https://api.wppfy.com/group/create \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"name": "Meu Novo Grupo",
"participants": [
"5521987905995"
]
}
'{
"group": {
"JID": "jid8@g.us",
"OwnerJID": "1232@s.whatsapp.net",
"OwnerPN": "<string>",
"Name": "Grupo de Soporte",
"NameSetAt": "2023-11-07T05:31:56Z",
"NameSetBy": "<string>",
"NameSetByPN": "<string>",
"Topic": "<string>",
"TopicID": "<string>",
"TopicSetAt": "2023-11-07T05:31:56Z",
"TopicSetBy": "<string>",
"TopicSetByPN": "<string>",
"TopicDeleted": true,
"IsLocked": true,
"IsAnnounce": true,
"AnnounceVersionID": "<string>",
"IsEphemeral": true,
"DisappearingTimer": 1,
"IsIncognito": true,
"IsParent": true,
"IsJoinApprovalRequired": true,
"LinkedParentJID": "<string>",
"IsDefaultSubGroup": true,
"DefaultMembershipApprovalMode": "<string>",
"GroupCreated": "2023-11-07T05:31:56Z",
"CreatorCountryCode": "<string>",
"ParticipantVersionID": "<string>",
"Participants": [
{
"JID": "<string>",
"LID": "<string>",
"PhoneNumber": "<string>",
"IsAdmin": true,
"IsSuperAdmin": true,
"DisplayName": "<string>",
"ImagePreview": "<string>",
"Error": 1,
"AddRequest": {
"Code": "<string>",
"Expiration": "2023-11-07T05:31:56Z"
},
"Username": "<string>"
}
],
"MemberAddMode": "",
"AddressingMode": "",
"OwnerCanSendMessage": true,
"OwnerIsAdmin": true,
"DefaultSubGroupId": "<string>",
"invite_link": "<string>",
"request_participants": "<string>",
"image_url": "<string>",
"image_preview_url": "<string>",
"picture_id": "<string>",
"picture_preview_id": "<string>",
"picture_empty_at": "2023-11-07T05:31:56Z",
"image_checked_at": "2023-11-07T05:31:56Z",
"image_preview_checked_at": "2023-11-07T05:31:56Z",
"parent_community": {
"jid": "<string>",
"name": "<string>",
"image_url": "<string>",
"image_preview_url": "<string>",
"default_subgroup_jid": "<string>"
},
"participant_profiles": [
{
"jid": "<string>",
"pn": "<string>",
"lid": "<string>",
"username": "<string>",
"display_name": "<string>",
"name": "<string>",
"image_url": "<string>",
"image_preview_url": "<string>",
"picture_id": "<string>",
"picture_preview_id": "<string>",
"is_admin": true,
"is_super_admin": true
}
],
"ParticipantCount": 1,
"request_participants_lid": "<string>"
},
"failed": [
"<string>"
]
}{
"error": "no valid WhatsApp participants",
"failed": [
"<string>"
]
}{
"error": "Error al crear el grupo"
}Autorizaciones
Cuerpo
Nombre del grupo
1 - 100"Grupo WppFy"
Invitados iniciales opcionales. Vacío, omitido o null crea el grupo solo con el creador, incluido automáticamente por WhatsApp.
Número con código de país, JID PN completo o LID conocido por la instancia.
["5521987905995", "5511912345678"]
Respuesta
Grupo creado con éxito