Ajuda

Como criar um Modelo de Envio de SMS Marketing utilizando a API da MailerWeb

Você poderá criar modelos para envios pelo SMS de forma programática utilizando a nossa API de gestão de contatos e campanhas, utilize os métodos abaixo para começar a criar conteúdo em nossa plataforma de envio de SMS Marketing.

Para se integrar à API é necessário que você esteja autenticado e para isso é importante que você tenha acesso ao artigo "Como se integrar a API da MailerWeb?"

Passo 1 - Criando um Modelo de Mensagens para SMS Marketing

Com esse método você poderá criar modelos de mensagens, inclusive com variáveis personalizadas. Para criar variáveis personalizadas consulte "Como criar um Campo Personalizado".

Para interagir com o Modelo de Mensagem para SMS, vamos criar o objeto com o seguinte endpoint e parâmetros:

  • Campo "name" é utilizado para apenas identificar o nome da mensagem, não será exibido ao destinatário
  • Campo "content" é utilizado para colocar o conteúdo da mensagem a ser enviada, podendo inclusive contendo variáveis personalizadas. O limite máximo de 140 mensagens por mensagem. Caso você extrapole o tamanho, a mensagem será tarifada a cada 140 caracteres.

Os campos personalizados sempre conterão o formato {{variavel}} e podem ser incluidos tanto no assunto como no corpo da mensagem.

POST: /api/v1/campaigns/sms_template/

data = {
   'name': 'Isso é um teste',
   'content': 'Olá {{name}} isso é um teste',
}

curl --dump-header - -H "Content-Type: application/json" \ -H "Authorization: ApiKey username:API_KEY"\ -X POST --data data https://painel.mailerweb.com.br/api/v1/campaigns/sms_template/ 

O resultado esperado será semelhante ao JSON abaixo:

{
    "date_created": "2020-10-27",
    "content": 'Olá {{name}} isso é um teste',
    "id": id-do-modelo-de-mensagem, 
    "last_updated": "2020-10-27", 
    "name": "Isso é um teste", 
    "resource_uri": "/api/v1/campaigns/sms_template/id-do-modelo-de-mensagem/", 
}

Repare que o ID da Modelo de Mensagem está no atributo ID e no atributo resource_url, onde você poderá acessar os detalhes da lista a partir do endpoint entregue por esse parâmetro. A partir de agora, grave esse ID, ele será utilizado para você relacionar as campanhas no momento que for criar uma.

Abaixo segue as variações de erros que podem acontecer ao tentar incluir um modelo de e-mail:

  • O campo content é obrigatório e não pode estar em branco

Agora que você está de posse do ID da do Modelo de SMS, vamos ao Passo 2

Passo 2 - Listando os Modelos de Mensagens para SMS

Para visualizar todos os modelos de e-mails criados em sua conta, utilize o método abaixo:


GET: /api/v1/campaigns/whatsapp_template/

curl --dump-header - -H "Content-Type: application/json" \ -H "Authorization: ApiKey username:API_KEY"\ -X GET https://painel.mailerweb.com.br/api/v1/campaigns/sms_template/ 

O resultado será semelhante a esse:

{
    "meta": {
        "limit": 10,
        "next": "/api/v1/campaigns/email_template/?limit=10&offset=10",
        "offset": 0,
        "previous": null,
        "total_count": 1
    },
    "objects": [
        {
           "date_created": "2020-10-27",
           "content": 'Olá {{name}} isso é um teste',
           "id": id-do-modelo-de-mensagem, 
           "last_updated": "2020-10-27", 
           "name": "Isso é um teste", 
           "resource_uri": "/api/v1/campaigns/sms_template/id-do-modelo-de-mensagem/", 
        }
    ]
}   

Importante notar que será exibido um objeto no formato JSON, onde virão 2 dicionários: meta e objects, a saber:

  • Em "meta" você terá uma visão geral de quantos objetos você possui e ainda o link da próxima página do objeto, isso estará no atributo "next" do dicionário;
  • Em objects, você terá um detalhe completo do objeto carregado no campo resource_uri, terá o link para chamar para a atualização desse objeto.

Você também poderá consultar objetos de acordo com os atributos existentes nesse formulário, por exemplo:

Listando os modelos por nome:


GET: /api/v1/campaigns/sms_template/?name=teste

curl --dump-header - -H "Content-Type: application/json" \ -H "Authorization: ApiKey username:API_KEY"\ -X GET https://painel.mailerweb.com.br/api/v1/campaigns/sms_template/?name=teste 

 

Passo 3 - Atualizando um Modelo de Mensagem para SMS

Para atualizar o modelo de mensagem para SMS, basta procurar o modelo por ID e realizar o seguinte post:

PATCH: /api/v1/campaigns/sms_template/id-modelo-do-template-de-sms/

data = {
   'content': 'Olá {{name}} isso é NÃO um teste',  # Nesse caso vamos atualizar apenas um campo
}

curl --dump-header - -H "Content-Type: application/json" \ -H "Authorization: ApiKey username:API_KEY"\ -X PATCH --data data https://painel.mailerweb.com.br/api/v1/campaigns/sms_template/id-modelo-do-template-de-sms/ 

O resultado entregue será algo semelhante:

{
    "date_created": "2020-10-27",
    "content": 'Olá {{name}} isso é NÃO um teste'
    "id": id-do-modelo-de-mensagem, 
    "last_updated": "2020-10-27", 
    "name": "Isso é um teste", 
    "resource_uri": "/api/v1/campaigns/sms_template/XXXX58/", 
}

Através de nossa API você conseguirá criar modelos de e-mail direto de sua aplicação sem a necessidade de utilizar o nosso painel de controle.

Retornar para Integração por API

Assine nossa newsletter