API da Zenvia: o que dá para fazer e como usar com agentes de IA
A Zenvia oferece API para enviar e receber mensagens por SMS, WhatsApp e outros canais, com templates, status de entrega e webhooks. É usada por empresas que fazem comunicação em escala com clientes, como avisos, cobranças e atendimento. O acesso é feito com token da conta do cliente.
Os grandes recursos da API, em português claro.
Envio de mensagens por SMS, WhatsApp e outros canais habilitados na conta.
Uso de modelos aprovados, necessários para iniciar conversas no WhatsApp.
Webhooks com as respostas que os clientes enviam.
Eventos de enviado, entregue, lido ou falha.
Disparos para listas, conforme os produtos contratados.
Como se acessa a API do Zenvia.
- Com credencial da sua empresaUsa token de API gerado no console da Zenvia, enviado no cabeçalho das requisições.
- Documentação oficialzenvia.github.io/zenvia-openapi-spec
- Envios em massa exigem consentimento do cliente (LGPD) e opção de descadastro.
- Templates de WhatsApp precisam de aprovação prévia.
- Defina teto de envios e custo por dia, já que cada mensagem é cobrada.
- api zenvia
- zenvia api
- api zenvia sms
- zenvia api whatsapp
- zenvia api documentação
- integração api zenvia
- webhook zenvia
O que um agente do iTeam faz com a API do Zenvia.
O agente envia a confirmação por WhatsApp, entende a resposta do cliente e remarca ou cancela na agenda.
O agente envia o aviso de vencimento com template aprovado e responde às dúvidas sobre o boleto.
Se a mensagem de WhatsApp falha, o agente reenvia por SMS e registra a tentativa.
Clientes que respondem a um disparo são atendidos pelo agente, que qualifica e passa ao vendedor.
Da credencial ao agente trabalhando, com aprovação.
Gerar o token e os canais
No console da Zenvia, gere o token e confirme os canais e templates aprovados.
Guardar no cofre do iTeam
Cadastre o token e defina quais templates e remetentes cada agente pode usar e o volume máximo por dia.
Testar com números internos
Envie primeiro para números do time e ative para clientes com aprovação dos disparos.
Dúvidas sobre a API do Zenvia.
A API da Zenvia é gratuita?
A API não é cobrada à parte, mas as mensagens enviadas são cobradas conforme canal e contrato.
Preciso programar para usar a API da Zenvia com o iTeam?
Não necessariamente. O iTeam lê a documentação da Zenvia e o time de implantação configura canais, templates e regras.
Dá para receber as respostas dos clientes?
Sim, por webhook. É assim que o agente continua a conversa depois do primeiro envio.
Como o agente de IA se autentica na API da Zenvia?
Com o token de API gerado no console da Zenvia e enviado no cabeçalho X-API-TOKEN. Há ainda um nível mais forte, com assinatura da requisição em outro cabeçalho. A especificação OpenAPI pública fica em zenvia.github.io. Guarde o token em cofre, nunca no texto do agente, e gere outro se houver suspeita de vazamento.
A Zenvia tem sandbox para testar mensagens de WhatsApp?
Tem: a Zenvia oferece um sandbox na plataforma, com token próprio na área de desenvolvedores, em que o número de destino precisa estar cadastrado como contato de teste. Há um limite diário de mensagens no sandbox, que pode ter mudado, então confira o valor atual na documentação. Use-o antes de pedir a ativação do canal real.
Que canais a API da Zenvia cobre além do SMS?
WhatsApp e outros canais de mensagem, num formato único de envio, com templates, recebimento de mensagens e status de entrega. Um agente pode, por exemplo, mandar um aviso por SMS e continuar a conversa pelo WhatsApp. Cada canal tem regras próprias, e os modelos de WhatsApp precisam de aprovação antes do uso.
Como o agente recebe as respostas dos clientes pela Zenvia?
Por webhooks: a Zenvia envia ao endereço configurado cada mensagem recebida e cada mudança de status, e o agente responde ou encaminha. Isso evita consultas repetidas. Os eventos podem chegar mais de uma vez, então o sistema deve tratar duplicatas. A assinatura do webhook valida que a chamada veio da Zenvia.
Como controlar o custo de um agente que envia mensagens pela Zenvia?
Cada mensagem enviada é cobrada, então defina um teto diário de envios e de gasto, uma lista de destinatários permitidos e aprovação para campanhas. O agente deve avisar quando chegar perto do limite. No iTeam existe teto de gasto por agente, mas o preço de cada envio vem do contrato com a Zenvia.
Posso usar a Zenvia com um agente para cobrar clientes?
Pode, desde que haja consentimento e opção de descadastro. O agente envia o lembrete com o link de pagamento, registra a promessa do cliente e escala para uma pessoa quem não responde ou contesta. O tom e as regras de cobrança são definidos pela empresa; a LGPD e o código do consumidor devem ser observados. Não é parecer jurídico.
Quando não vale a pena usar a Zenvia com um agente de IA?
Quando o volume é baixo e os avisos são totalmente fixos, caso em que um disparo simples por regra já resolve. O agente se justifica quando há conversa de volta, exceções e dados a consultar. Se a empresa não tem consentimento organizado dos contatos, resolva isso antes de enviar qualquer coisa.
Os telefones e mensagens da Zenvia são dados pessoais para a LGPD?
São: número de telefone e conteúdo de conversas identificam pessoas. O agente deve usar só os contatos autorizados, respeitar pedidos de saída e guardar registros pelo tempo definido pela empresa. Os envios ficam registrados na trilha de auditoria da plataforma. Não é parecer jurídico: valide as regras com o encarregado de dados.
