Maytapi
Maytapi/Documentação/Getting started
Getting startedCerca de 10 minutosComo enviar sua primeira mensagem de WhatsApp pela API
De uma conta nova a uma mensagem entregue em quatro passos: pareie seu número, copie suas credenciais, envie uma requisição e receba a confirmação de entrega. Sem processo de aprovação e sem templates.
- pareamento por QR
- pid e token
- uma requisição POST
- entrega no webhook
Quatro passos até a primeira mensagem
Tudo abaixo é feito no console e em um terminal — sem SDK.
-
step 1
Crie uma conta
Cadastre-se no console e comece o teste grátis — sem cartão.
-
step 2
Pareie seu número
Adicione um telefone e leia o QR code com o WhatsApp do celular (Aparelhos conectados). Seu número continua igual.
-
step 3
Copie suas credenciais
Seu pid e seu token ficam na página de token do console; o phone_id aparece ao lado do seu número.
-
step 4
Envie a requisição
Faça um POST para /sendMessage com o header x-maytapi-key e um corpo JSON.
Encontre pid, phone_id e token
Todas as requisições usam a mesma URL base com seu pid e phone_id, e seu token no header x-maytapi-key. Você também pode listar seus telefones pela API.
- ✓Token e pid: console → Settings → Token
- ✓phone_id: ao lado de cada número ou via /listPhones
- ✓Mantenha o token em segredo — ele dá acesso total à sua conta
curl "https://api.maytapi.com/api/$PID/listPhones" \ -H "x-maytapi-key: $TOKEN"
Envie a primeira mensagem
Envie uma mensagem de texto para qualquer número de WhatsApp em formato internacional. A requisição coloca a mensagem na fila do seu telefone e responde na hora.
- ✓to_number em formato internacional, ex.: 55119xxxxxx67
- ✓type: text com um message
- ✓A resposta traz o id da mensagem
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "55119xxxxxx67",
"type": "text",
"message": "Hello from the Maytapi WhatsApp API!"
}'const res = await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ to_number: "55119xxxxxx67", type: "text", message: "Hello from the Maytapi WhatsApp API!" })
});
console.log(await res.json());import requests
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={"to_number": "55119xxxxxx67", "type": "text", "message": "Hello from the Maytapi WhatsApp API!"},
timeout=10,
)
print(res.json())Confira se chegou
Configure um webhook para receber confirmações de entrega e leitura, ou verifique o status do telefone se uma mensagem não sair.
- ✓/setWebhook para confirmações e mensagens recebidas
- ✓/{phone_id}/status e /screen para a sessão
- ✓/{phone_id}/queue para ver mensagens pendentes
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/status" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/queue" \ -H "x-maytapi-key: $TOKEN"
curl -X POST "https://api.maytapi.com/api/$PID/setWebhook" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhook": "https://example.com/maytapi/webhook"
}'Para onde ir depois
-
Receba mensagens
Configure o webhook para receber mensagens e confirmações.
-
Adicione botões
Envie botões, listas e carrosséis pelo mesmo endpoint.
-
Evite banimentos
Aqueça números novos e entenda o que provoca restrições.
Perguntas frequentes para começar
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →Preciso de um número novo?
Não. Você pareia seu número de WhatsApp atual com um QR code e ele continua funcionando no celular normalmente.
Por que minha mensagem não chegou?
Verifique primeiro o status do telefone — a sessão precisa estar ativa. Depois veja a fila e os logs no console. O WhatsApp também pode limitar as primeiras mensagens para números novos; veja o guia contra banimento.
Posso testar sem pagar?
Sim. O teste libera todos os endpoints por três dias, sem cartão.
Mais recursos da API do WhatsApp
Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.