links e convites de chamada
Link de ligação do WhatsApp gerado pela API, com convite e horário marcado
Com o link de ligação do WhatsApp gerado pela API, o seu SaaS cria chamadas de áudio ou vídeo para compartilhar e envia convites agendados, com título e horário, que o contato abre no próprio WhatsApp.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Áudio ou vídeo
POST /calls/create-link aceita mediaType audio ou video e devolve a URL do link e o horário de início.
Convite que chega na conversa
POST /calls/send-event envia ao contato uma mensagem de chamada agendada com título, horário e o link.
Link próprio, se preferir
O convite pode usar uma URL de outra ferramenta de reunião no lugar do link do WhatsApp.
Horário no fuso do Brasil
Datas como 20/02/2026 10:00 são lidas no horário de Brasília. ISO 8601 respeita o fuso informado.
O link de ligação do WhatsApp resolve a chamada que não deveria ser de surpresa. A nutricionista quer a teleconsulta às 15h, a mentoria da edtech acontece toda terça às 19h, o consultor marca a reunião de implantação com o cliente novo. Em vez de tocar o telefone no meio do dia de alguém, o seu SaaS manda um convite com título e horário, e a pessoa entra pela conversa do WhatsApp que já tem com a empresa.
Na D-API, isso são dois endpoints da família de ligações WhatsApp API: um cria o link, outro envia o convite agendado. Os dois rodam na conexão não-oficial do seu cliente, a mesma que já envia as mensagens.
Gerar um link de ligação do WhatsApp
POST /api/v1/calls/create-link cria um link de chamada do WhatsApp que pode ser compartilhado. Só sessionId é obrigatório; mediaType escolhe audio (o padrão) ou video, e startTime define o horário de início.
curl -X POST https://api.d-api.cloud/api/v1/calls/create-link \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "minha-sessao",
"mediaType": "video",
"startTime": "20/02/2026 15:00"
}'
A resposta traz o link pronto em data:
{
"success": true,
"message": "Call link created successfully",
"sessionId": "minha-sessao",
"data": {
"token": "...",
"mediaType": "video",
"startTime": "2026-02-20T18:00:00Z",
"url": "https://..."
}
}
Guarde data.url no agendamento do seu sistema. Ele pode ir num e-mail, num SMS, numa mensagem de texto com botão ou na tela de confirmação do seu produto. Se a sessão não existir ou não for da sua conta, a resposta é 404; se a criação falhar na conexão, 400 com o motivo em error.
Como o horário é lido
O startTime aceita formatos que um SaaS brasileiro já tem no banco. 20/02/2026 15:00 e 2026-02-20 15:00, com ou sem segundos, são interpretados no fuso GMT-03. ISO 8601 com fuso, como 2026-02-20T15:00:00-03:00, respeita o fuso informado. Sem startTime, ou com um valor que não dê para interpretar, vale o momento da requisição. Para evitar surpresa com horário de verão em outros países, prefira ISO 8601 quando o seu cliente atende fora do Brasil.
Enviar um convite de chamada agendada
O link sozinho resolve metade. A outra metade é o contato receber o convite no lugar certo. POST /api/v1/calls/send-event envia ao destinatário uma mensagem de chamada agendada, com título e horário, direto na conversa.
curl -X POST https://api.d-api.cloud/api/v1/calls/send-event \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "minha-sessao",
"to": "5511999999999",
"title": "Teleconsulta de retorno",
"scheduledTime": "2026-02-20 15:00",
"callType": "video"
}'
Os campos:
| Campo | Obrigatório | Para que serve |
|---|---|---|
sessionId |
Sim | Conexão que envia o convite |
to |
Sim | Destinatário |
title |
Não | Nome do evento que aparece no convite |
scheduledTime |
Não | Horário, nos mesmos formatos do startTime |
callType |
Não | audio (padrão) ou video |
createCallLink |
Não | Cria o link do WhatsApp junto; true quando omitido |
customCallLinkUrl |
Não | URL de outra ferramenta de reunião no lugar do link |
A resposta traz data.messageId e data.timestamp da mensagem enviada e, quando o link foi criado, data.callLink com url, token, mediaType e startTime. Com o messageId, o seu sistema casa o convite com os eventos de status de mensagem que chegam pelo webhook.
Onde o link de ligação encaixa em cada SaaS
Clínicas e telemedicina. Ao confirmar a consulta online, o sistema chama /calls/send-event com callType: "video" e o horário da agenda. O paciente recebe o convite na mesma conversa onde chegam os lembretes, sem baixar outro aplicativo.
Edtech e mentorias. A plataforma cria um link de vídeo por turma com /calls/create-link e publica a URL na área do aluno. O convite individual, com o título da aula, vai para quem se inscreveu.
CRM e vendas consultivas. O vendedor marca a demonstração no pipeline e o convite sai do número comercial, com título “Demonstração” e horário. Se a empresa já usa outra ferramenta de vídeo, o customCallLinkUrl mantém o link dela e o WhatsApp vira só o canal do convite.
Software de agendamento. Quando o cliente final escolhe um horário de atendimento remoto no seu widget, o convite já sai com o horário que ele escolheu, no fuso de Brasília.
Como encaixar no seu produto sem retrabalho
Num SaaS multi-tenant, cada cliente tem a própria conexão, então o convite sai do número dele, com o nome e a foto que o contato já reconhece. O sessionId que você já guarda por cliente para enviar mensagens é o mesmo que entra nestes dois endpoints. Não há cadastro extra nem configuração por conta.
Três decisões de modelagem evitam dor de cabeça depois:
- Salve o link junto do agendamento. Grave
data.url(oudata.callLink.url) e omessageIdna mesma linha do evento no seu banco. Se o paciente pedir o link de novo, o atendente reenvia o mesmo, sem gerar outro. - Trate o horário como dado do agendamento. Passe para
scheduledTimeo mesmo valor que aparece na tela do seu cliente, em vez de recalcular fuso no código. Os formatos brasileiros já são lidos em GMT-03. - Separe falha de criação de falha de entrega. Um 400 do endpoint significa que o convite não saiu; registre o
errore mostre ao usuário. A entrega na conversa você acompanha pelos eventos de status de mensagem do webhook, descritos no artigo sobre webhook WhatsApp API.
Link, convite ou ligação direta
Cada ferramenta tem um momento. A ligação direta pela API, com /calls/place ou /calls/stream, serve quando a conversa é agora e parte do seu sistema; está em fazer ligações de WhatsApp pela API. O link serve quando a chamada tem hora marcada ou várias pessoas vão entrar. O convite agendado é o link entregue no lugar certo, com contexto.
Para lembrar o contato pouco antes do horário, uma mensagem com botão costuma converter melhor que outro convite; o artigo sobre mensagens interativas no WhatsApp mostra as opções. A referência completa dos dois endpoints está na documentação da D-API.
Time D-API. Atualizado em .
Perguntas frequentes
Qual o formato do horário em startTime e scheduledTime?
A API aceita d/m/Y H:i (ex.: 20/02/2026 10:00) e Y-m-d H:i, com ou sem segundos, lidos no fuso GMT-03, e também ISO 8601 com fuso. Sem horário, ou com um valor que não dê para interpretar, vale o momento da requisição.
Preciso criar o link antes de enviar o convite?
Não. O /calls/send-event cria o link do WhatsApp por padrão (createCallLink é true quando omitido) e devolve os dados dele na resposta, em data.callLink. Crie à parte só se quiser o link sem enviar mensagem.
Posso usar o link do meu próprio sistema de vídeo?
Sim. No /calls/send-event, envie customCallLinkUrl com a URL da sua ferramenta de reunião. O convite chega no WhatsApp do contato com o título, o horário e esse endereço.
O link de ligação tem custo?
Não há cobrança por link ou por convite. Os dois endpoints usam a conexão não-oficial do seu cliente, cobrada por conexão ativa, sem custo por mensagem ou ligação.