Links

Campanhas API

Documentação técnica: API para Campanhas

Autenticação

A autenticação para consultas via API tem um formato padrão e é preciso apresentar um username válido (e-mail), e o token de autenticação (veja como acessar os seus dados). É necessário adicionar os seguintes headers à requisição:
Campo
Detalhes
Data Type
UserName
E-mail válido para autenticação no ChatClub.
String
AutenticaçãoToken
Token de autenticação gerado por nossa plataforma. Encontre aqui ou consulte nosso suporte.
String

Detalhes de conexão

Hostname
apigw.wavy.global
Porta
443 (https)
Protocolo
HTTPS (TLS encryption)
Autenticação
username + token
Encoding
UTF-8

Listar campanhas

Listagem das campanhas já cadastradas na plataforma. É possível paginar os resultados ou filtrar pelo nome da campanha.
GET https://apigw.wavy.global/api/v1/campaigns

Parâmetros da QueryString

Campo
Detalhes
Tipo
name
Nome de uma campanha como filtro para a listagem
String
page
Página a ser listada
Integer
page_size
Total de campanhas por página
Integer
Resposta positiva
HEADERS:
page-number: 1
per-page: 10
total: 2
total-pages: 1

Informando o total de campanhas que tem e Exibindo logo abaixo:

{
"status": {
"error": false
},
"campaigns": [
{
"name": "My first campaign",
"id": 1,
"alias": "first"
},
{
"name": "My second campaign",
"id": 2,
"alias": "second"
}
]
}

Demonstrando

Buscar uma campanha

Busca os dados de uma campanha pelo ID de cadastro
É necessário conhecer anteriormente o ID de cadastro
GET https://apigw.wavy.global/api/v1/campaign/{id}

Criar campanha

Exemplo de criação de uma campanha:
Criação de uma nova campanha com nome e alias. O alias da campanha deve ser um nome simple para facilitar o uso com a API. Recomenda-se que seja curto e não utilize caracteres especiais.
POST https://apigw.wavy.global/api/v1/campaigns

Parâmetros do JSON

* Campo obrigatório
Campo
Detalhes
Tipo
name*
Nome da campanha
String
alias
Identificador da campanha para utilização na API
String
Chamado
{
"campaign" : {
"name": "My Campaign2019",
"alias": "mycampaign2019"
}
}
Resposta
{
"status": {
"error": false
},
"campaign": {
"name": "My Campaign",
"id": 1234,
"alias": "mycampaign"
}
}

Alterar campanha

Alteração de uma campanha podendo modificar o nome e/ou o alias.
PUT https://apigw.wavy.global/api/v1/campaigns/{id}
É necessário incluir o {id} da campanha que deseja realizar uma alteração

Parâmetros do JSON

* Campo obrigatório
Campo
Detalhes
Tipo
name*
Nome da campanha
String
alias
Identificador da campanha para utilização na API
String
Chamado
{
"campaign" : {
"name": "My Campaign",
"alias": "mycampaign"
}
}
Resposta
{
"status": {
"error": false
},
"campaign": {
"name": "My Campaign",
"id": 1234,
"alias": "mycampaign"
}
}

Excluir campanha

Exclusão de uma campanha pelo ID.
DELETE https://apigw.wavy.global/api/v1/campaigns/{id}
É necessário incluir o {id} da campanha que deseja realizar uma alteração