Pular para o conteúdo principal

Metadata do canal

Método#

/newsletter/metadata#

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/newsletter/metadata/{newsletterId}

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Conceituação#

Este método retorna o metadata do canal com todas as informações do canal e de sua visualização.


Atributos#

Obrigatórios#

AtributosTipoDescrição
idstringID do canal

Request Params#

URL#

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/newsletter/metadata/{newsletterId}

warning

O id do canal sempre deve conter o sufixo "@newsletter", pois esse é o padrão utilizado pelo próprio WhatsApp.


Response#

200#

AtributosTipoDescrição
idstringID do canal
creationTimetimestampTimestamp da data de criação do grupo
statestringEstado do canal (ACTIVE, NON_EXISTING)
namestringNome do canal
descriptionstringDescrição do canal
subscribersCountstringContagem do número de seguidores do canal
inviteLinkstringLink de convite do canal
verificationstringIndica se o canal é verificado ou não (VERIFIED, UNVERIFIED)
picturestringUrl da imagem do canal
previewstringUrl de preview da imagem do canal
viewMetadataobjectObjeto com informações de visualização

Object (viewMetadata)

AtributosTipoDescrição
mutestringIndica se o canal esta mutado ou não (ON, OFF)
rolestringIndica se é o proprietário ou seguidor do canal (OWNER, SUBSCRIBER)

Exemplo

{
"id": "999999999999999999@newsletter",
"creationTime": "1695643504",
"state": "ACTIVE",
"name": "Z-API",
"description": "Canal oficial Z-API",
"subscribersCount": "123",
"inviteLink": "https://www.whatsapp.com/channel/0029Va5Xk71a",
"verification": "VERIFIED",
"picture": "https://mmg.whatsapp.net/v/t61.24694-24/383686038_859672472421500_990610487096734362_n.jpg?ccb=11-4&oh=01_AdS-Wk3RSfXmtEqDA4-LTFaZQILXZSprywV8EwNoZPOaGw&oe=651EF162&_nc_sid=000000&_nc_cat=111",
"preview": "https://mmg.whatsapp.net/v/t61.24694-24/383686038_859672472421500_990610487096734362_n.jpg?stp=dst-jpg_s192x192&ccb=11-4&oh=01_AdRltWYOZftf0cnm-GNw5RRGoxQ53nJR9zzxxot_N7JQCw&oe=651EF162&_nc_sid=000000&_nc_cat=111",
"viewMetadata": {
"mute": "OFF",
"role": "OWNER"
}
}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no inicio deste tópico.

415#

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"


Code#