Pular para o conteúdo
D-APITestar grátis

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.

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.

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 (ou data.callLink.url) e o messageId na 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 scheduledTime o 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 error e 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.

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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.