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 Suporte",
    "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": "Failed to create group"
}

Grupos e Comunidades

Criar um novo grupo

Cria um grupo com participantes iniciais opcionais. O WhatsApp inclui o criador automaticamente.

Envie participants: [], omita o campo ou use null para criar um grupo somente com o criador. Informar apenas o próprio PN/LID tem o mesmo efeito; não é necessário adicionar o criador manualmente.

Para adicionar outras pessoas, informe números com DDI (apenas dígitos) ou JIDs PN completos, como 5511999999999@s.whatsapp.net. JIDs LID conhecidos pela instância também são aceitos. Participantes são verificados e duplicatas/aliases do criador são removidos. Uma lista com convidados inválidos e nenhum convidado válido continua retornando 400; ela não é convertida silenciosamente em grupo vazio.

A resposta contém group e failed. Quem a privacidade impediu de entrar fica em failed, sem o código do convite individual: para convidar, chame POST /group/updateParticipants com action: add (veja Convidar pessoas). Depois da criação, o administrador pode obter o convite em GET /group/invitelink/{groupJID}, usando group.JID.

POST

group

create

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 Suporte",
    "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": "Failed to create group"
}

Autorizações

token

string

header

obrigatório

Corpo

application/json

name

string

obrigatório

Nome do grupo

Required string length: 1 - 100

Exemplo:

"WppFy grupo"

participants

string[] | null

Convidados iniciais opcionais. Vazio, omitido ou null cria o grupo somente com o criador, incluído automaticamente pelo WhatsApp.

Número com DDI, JID PN completo ou LID conhecido pela instância.

Exemplo:

["5521987905995", "5511912345678"]

Resposta

Grupo criado com sucesso

group

object

obrigatório

Representa um grupo/conversa coletiva

Show child attributes

failed

string[]

obrigatório

JIDs de quem não entrou (número inválido, sem WhatsApp ou bloqueado pela privacidade). Não traz o código do convite individual. Vazio quando todos entraram.

Instancia

CRM

Proxy

Perfil

Enviar Mensagem

Mensagem Async

Ações na mensagem e Buscar

Grupos e Comunidades

Newsletters e Canais

Server-Sent Events (SSE)

Bloqueios

Etiquetas

Chats

Contatos

Chamadas

Integração Chatwoot

Business

Respostas Rápidas

Criar um novo grupo

Autorizações

Corpo

Resposta