Personalização de Campanhas
Upload de imagens, mensagem de boas-vindas, logo, banner e cor de fundo. Mais controle criativo sobre suas campanhas, menos tempo de ativação para campanhas personalizadas.
Agora é possível configurar mensagens de boas-vindas, adicionar logo, banner e definir as cores para e-mail de resgate e interface de resgate diretamente no payload da API. Essa atualização permite uma experiência mais rica e personalizada, com maior autonomia na criação de campanhas e menos dependência de intervenções pela equipe técnica.
Além disso, foi adicionada uma nova rota dedicada para upload de imagens, que permite o envio de ativos como logo e banners diretamente pelas nossas APIs.
Mais controle criativo, menos ajustes manuais.
Upload de imagens
A partir da nova rota para upload de imagens é possível definir os ativos de imagem que serão exibidos no e-mail de resgate e interface de resgate para o consumidor final.
INFO
Para instruções sobre envio de imagens, formatos compatíveis e exemplos de requisição, consulte a seção Upload de Imagens.
Exemplo de Requisição
curl --request POST \
--url https://api.minu.biz/v1/upload/logo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'image=@"/path/image/minu-logo.png"'Personalização de campanhas
A partir desta versão, nossa API passou a oferecer suporte a envio de atributos de personalização diretamente no payload da requisição.
appreciationMessage: Personalize a mensagem de boas-vindas que será exibida na interface de resgate do consumidor final.backgroundColor: Defina a cor do e-mail de resgate e interface de resgate.logo: Adicione sua logo, fortaleça a presença da marca.banner: Personalize a interface de resgate com ativos alinhados a sua identidade visual.
Mais controle criativo, menos ajustes manuais.
INFO
Para instruções completas sobre parâmetros e estrutura de payload, consulte a seção Criando campanhas.
Mensagem de boas vindas
A funcionalidade de mensagem de boas-vindas permite adicionar um texto personalizado à interface de resgate do consumidor por meio do campo appreciationMessage no payload. Esse recurso oferece uma camada adicional de personalização na experiência do usuário, reforçando o tom de comunicação da campanha e aproximando a marca do consumidor.
Exemplo de requisição
curl --request POST \
--url https://api.minu.biz/v1/campaigns \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
"startDate": "2025-07-01T00:00:00",
"endDate": "2025-30-30T23:59:59",
"experience": {
"title": "Campanha Demo Minu",
"sponsor": "Minu",
"appreciationMessage": "Temos recompensas pra você. Acesse agora e faça a sua escolha!"
},
"type": "qualify-reward",
"settings": {
"prizes": ["ifood-credito-r10", "ifood-credito-r20", "ifood-credito-r50"],
"rewardOffer":{
"amount":50,
"currency":"BRL",
"prefix":"Ganhe",
"suffix":"em bônus"
},
"defaultPrizeList": ["ifood-credito-r50"],
"rewardLimit": {
"quantity": 3,
"period": "daily"
}
}
}'Definindo cor de fundo
A funcionalidade de cor de fundo permite definir a tonalidade visual aplicada ao e-mail de resgate e à interface de resgate do consumidor por meio do campo backgroundColor no payload. Esse recurso contribui para reforçar a identidade visual da campanha e permite alinhar visualmente a experiência do usuário à identidade da marca.
Exemplo de requisição
curl --request POST \
--url https://api.minu.biz/v1/campaigns \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
"startDate": "2025-07-01T00:00:00",
"endDate": "2025-30-30T23:59:59",
"experience": {
"title": "Campanha Julho com sabor",
"sponsor": "Minu",
"backgroundColor": "#003033"
},
"type": "qualify-reward",
"settings": {
"prizes": ["ifood-credito-r10", "ifood-credito-r20", "ifood-credito-r50"],
"rewardOffer":{
"amount":50,
"currency":"BRL",
"prefix":"Ganhe",
"suffix":"em bônus"
},
"defaultPrizeList": ["ifood-credito-r50"],
"rewardLimit": {
"quantity": 3,
"period": "daily"
}
}
}'Ajuste de contraste
A funcionalidade de contraste ajusta dinamicamente a cor dos elementos visuais (fontes e assets) com base na cor de fundo definida no payload da requisição, garantindo acessibilidade visual e consistência estética.
Adicionando logo e banner
A opção de adicionar imagens de logotipo e banner permite incorporar elementos visuais personalizados diretamente à interface de resgate da campanha, reforçando a identidade da marca ao longo da jornada do consumidor. Por meio dos campos logoId e bannerId no payload da API, é possível referenciar ativos previamente enviados via rota de Upload de imagens, garantindo consistência estética e comunicação visual alinhada com a proposta da campanha.
Exemplo de requisição
curl --request POST \
--url https://api.minu.biz/v1/campaigns \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
"startDate": "2025-07-01T00:00:00",
"endDate": "2025-30-30T23:59:59",
"experience": {
"title": "Campanha Julho com sabor",
"sponsor": "Minu",
"logoId": "6862cedfd984b08906262940",
"bannerId": "6862i3dbd484b0890626293d"
},
"type": "qualify-reward",
"settings": {
"prizes": ["ifood-credito-r10", "ifood-credito-r20", "ifood-credito-r50"],
"rewardOffer":{
"amount":50,
"currency":"BRL",
"prefix":"Ganhe",
"suffix":"em bônus"
},
"defaultPrizeList": ["ifood-credito-r50"],
"rewardLimit": {
"quantity": 3,
"period": "daily"
}
}
}'Conclusão
- Nova rota de upload de imagens: Facilidade no envio de ativos visuais, agilizando a integração e mantendo consistência com a identidade da marca.
- Personalização de campanhas: Personalização de mensagens, cores, logo e banner diretamente pelo payload, eliminando dependências operacionais.
Com esta atualização, a API de campanhas evolui para entregar mais flexibilidade, autonomia e controle criativo aos nossos clientes.
Este é um passo importante em nossa busca para oferecer campanhas memoráveis e com menos fricção.